Referência da API
Chat Completions
Modelos deste endpoint (5)
/v1/chat/completionsO endpoint principal: chat de vários turnos, streaming, chamada de ferramentas, visão e modo JSON para todos os modelos de chat do catálogo.
#Parâmetros da requisição
modelstringobrigatórioID do modelo em /v1/models. O gateway determina o provedor upstream a partir desse valor.
messagesarrayobrigatórioTurnos da conversa: {role: system|user|assistant|tool, content}. content pode ser uma string ou um array de partes multimodais.
streambooleanopcionaltrue transmite deltas SSE, encerrados por data: [DONE].
temperaturenumberopcionalDe 0 a 2. Deixe vazio para usar o padrão do modelo.
max_tokensintegeropcionalLimite máximo de tokens gerados; também limita a estimativa de cota pré-reservada.
toolsarrayopcionalDeclarações de funções que o modelo pode chamar — veja o guia de chamada de ferramentas.
tool_choicestring | objectopcional"auto", "none" ou fixe uma função específica.
response_formatobjectopcional{"type":"json_object"} ou um wrapper json_schema para saída estruturada nos modelos compatíveis.
top_pnumberopcionalAmostragem nucleus; use temperature ou top_p, não os dois.
stopstring | arrayopcionalAté 4 sequências de parada que interrompem a geração.
#Erros relacionados
- 400 invalid_request_errorCorpo malformado ou parâmetro não suportado por este modelo.
- 401Bearer token inválido ou ausente. Não há error.code neste caminho — verifique o status.
- 402 insufficient_user_quotaO saldo da carteira não cobre a estimativa pré-reservada.
- 429Limitação por chave. Corpo vazio; aguarde o Retry-After. Um 429 que traz insufficient_user_quota indica, na verdade, o limite de gastos diário.
- 503 model_not_foundModelo desconhecido, ou nenhum canal saudável o atende no momento.
#Exemplo de requisição
curl https://www.aisplice.store/v1/chat/completions \
-H "Authorization: Bearer sk-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-luna",
"messages": [{"role": "user", "content": "Say hello."}]
}'#Resposta
{
"id": "chatcmpl-…",
"object": "chat.completion",
"model": "gpt-5.6-luna",
"choices": [{
"index": 0,
"message": {"role": "assistant", "content": "Hello!"},
"finish_reason": "stop"
}],
"usage": {"prompt_tokens": 9, "completion_tokens": 3, "total_tokens": 12}
}Ainda com problemas?
Envie para nós o ID da requisição ou a mensagem de erro e vamos investigar.