Referência da API › Recursos
Chat
Chame um modelo de IA direto, sem agente, com resposta inteira ou em streaming.
POST/api/chat/completions#
Manda mensagens direto para um modelo, sem instruções de agente, conectores ou histórico salvo. Use para classificar, resumir, extrair dados ou gerar texto dentro dos seus sistemas.
| Campo | Tipo | Descrição |
|---|---|---|
messages | array, 1 a 200 | Obrigatório. Itens { "role": "user" | "assistant", "content": "texto" }. |
model | string | provedor/modelo, por exemplo anthropic/claude-sonnet-5.5. Sem ele, usa o padrão: o DoubleX Auto (openrouter/auto) nas organizações com créditos da plataforma. Veja os IDs em Modelos. |
system | string | Instrução de sistema. |
maxTokens | número, 1 a 128.000 | Limite de tokens da resposta. |
temperature | número, 0 a 2 | |
stream | boolean | true para receber em partes. Padrão false. |
Resposta inteira#
curl -X POST https://doublex.ai/api/chat/completions \
-H "Authorization: Bearer $DOUBLEX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"system": "Responda só com Positivo, Negativo ou Neutro.",
"messages": [{ "role": "user", "content": "Adorei o atendimento, resolveram rápido." }]
}'JSON
{
"provider": "openrouter",
"model": "openrouter/auto",
"servedModel": "google/gemini-3.8-flash",
"text": "Positivo",
"usage": { "inputTokens": 31, "outputTokens": 2, "costUsd": 0.00002 }
}servedModel é o modelo que de fato respondeu (útil com o DoubleX Auto).
Streaming#
Com "stream": true, a resposta chega em NDJSON:
NDJSON
{"type":"delta","text":"Posi"}
{"type":"delta","text":"tivo"}
{"type":"done","provider":"openrouter","model":"openrouter/auto","servedModel":"google/gemini-3.8-flash","text":"Positivo","usage":{"inputTokens":31,"outputTokens":2,"costUsd":0.00002}}type | Campos |
|---|---|
delta | text: o próximo pedaço da resposta. |
done | A resposta completa, com text, usage e o modelo usado. |
error | error: a mensagem de erro. |
Se você fechar a conexão no meio, a chamada ao modelo também é cancelada.
Erros#
| Status | code | Quando |
|---|---|---|
400 | no_provider | Não há modelo disponível para você. |
400 | model_unavailable | O modelo pedido não está no catálogo ou não está liberado. |
402 | no_credits | Os créditos da organização acabaram. |
402 | plan_required | A organização ainda não escolheu um plano. |
502 | provider_error | O provedor do modelo falhou. No streaming, chega como evento error. |
Cada chamada consome créditos pelo custo do modelo e aparece no relatório de Uso e créditos com origem Terminal (CLI).