DoubleX AgentesDocs

Referencia de la API › Recursos

Chat

Llama a un modelo de IA directamente, sin agente, con respuesta completa o en streaming.

POST/api/chat/completions#

Envía mensajes directamente a un modelo, sin instrucciones de agente, conectores ni historial guardado. Úsalo para clasificar, resumir, extraer datos o generar texto dentro de tus sistemas.

CampoTipoDescripción
messagesarray, de 1 a 200Obligatorio. Elementos { "role": "user" | "assistant", "content": "texto" }.
modelstringproveedor/modelo, por ejemplo anthropic/claude-sonnet-5.5. Sin él, usa el predeterminado: DoubleX Auto (openrouter/auto) en las organizaciones con créditos de la plataforma. Consulta los IDs en Modelos.
systemstringInstrucción de sistema.
maxTokensnúmero, de 1 a 128.000Límite de tokens de la respuesta.
temperaturenúmero, de 0 a 2
streambooleantrue para recibir por partes. Predeterminado: false.

Respuesta completa#

curl -X POST https://doublex.ai/api/chat/completions \
  -H "Authorization: Bearer $DOUBLEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "system": "Responde solo con Positivo, Negativo o Neutro.",
    "messages": [{ "role": "user", "content": "Me encantó la atención, lo resolvieron 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 es el modelo que realmente respondió (útil con DoubleX Auto).

Streaming#

Con "stream": true, la respuesta llega en 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: el siguiente fragmento de la respuesta.
doneLa respuesta completa, con text, usage y el modelo usado.
errorerror: el mensaje de error.

Si cierras la conexión a mitad de camino, la llamada al modelo también se cancela.

Errores#

EstadocodeCuándo
400no_providerNo hay un modelo disponible para ti.
400model_unavailableEl modelo pedido no está en el catálogo o no está habilitado.
402no_creditsLa organización se quedó sin créditos.
402plan_requiredLa organización todavía no eligió un plan.
502provider_errorEl proveedor del modelo falló. En el streaming, llega como evento error.

Cada llamada consume créditos según el costo del modelo y aparece en el informe de Uso y créditos con origen Terminal (CLI).