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.
| Campo | Tipo | Descripción |
|---|---|---|
messages | array, de 1 a 200 | Obligatorio. Elementos { "role": "user" | "assistant", "content": "texto" }. |
model | string | proveedor/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. |
system | string | Instrucción de sistema. |
maxTokens | número, de 1 a 128.000 | Límite de tokens de la respuesta. |
temperature | número, de 0 a 2 | |
stream | boolean | true 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}}type | Campos |
|---|---|
delta | text: el siguiente fragmento de la respuesta. |
done | La respuesta completa, con text, usage y el modelo usado. |
error | error: el mensaje de error. |
Si cierras la conexión a mitad de camino, la llamada al modelo también se cancela.
Errores#
| Estado | code | Cuándo |
|---|---|---|
400 | no_provider | No hay un modelo disponible para ti. |
400 | model_unavailable | El modelo pedido no está en el catálogo o no está habilitado. |
402 | no_credits | La organización se quedó sin créditos. |
402 | plan_required | La organización todavía no eligió un plan. |
502 | provider_error | El 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).