DoubleX AgentesDocs

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.

CampoTipoDescrição
messagesarray, 1 a 200Obrigatório. Itens { "role": "user" | "assistant", "content": "texto" }.
modelstringprovedor/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.
systemstringInstrução de sistema.
maxTokensnúmero, 1 a 128.000Limite de tokens da resposta.
temperaturenúmero, 0 a 2
streambooleantrue 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}}
typeCampos
deltatext: o próximo pedaço da resposta.
doneA resposta completa, com text, usage e o modelo usado.
errorerror: a mensagem de erro.

Se você fechar a conexão no meio, a chamada ao modelo também é cancelada.

Erros#

StatuscodeQuando
400no_providerNão há modelo disponível para você.
400model_unavailableO modelo pedido não está no catálogo ou não está liberado.
402no_creditsOs créditos da organização acabaram.
402plan_requiredA organização ainda não escolheu um plano.
502provider_errorO 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).