Referência da API

Chat Completions

POST/v1/chat/completions

O 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ório

    ID do modelo em /v1/models. O gateway determina o provedor upstream a partir desse valor.

  • messagesarrayobrigatório

    Turnos da conversa: {role: system|user|assistant|tool, content}. content pode ser uma string ou um array de partes multimodais.

  • streambooleanopcional

    true transmite deltas SSE, encerrados por data: [DONE].

  • temperaturenumberopcional

    De 0 a 2. Deixe vazio para usar o padrão do modelo.

  • max_tokensintegeropcional

    Limite máximo de tokens gerados; também limita a estimativa de cota pré-reservada.

  • toolsarrayopcional

    Declaraçõ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_pnumberopcional

    Amostragem nucleus; use temperature ou top_p, não os dois.

  • stopstring | arrayopcional

    Até 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.

Tabela completa de códigos de erro →

#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

response.json
{
  "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.