DoubleX AgentesDocs

Referencia de la API › Recursos

Modelos y créditos

Catálogo de modelos con precio en créditos, proveedores disponibles, saldo y consumo de la organización.

GET/api/models/catalog#

Catálogo de los modelos de la plataforma, con el precio de cada uno en créditos.

curl https://doublex.ai/api/models/catalog -H "Authorization: Bearer $DOUBLEX_API_KEY"
JSON
{
  "platform": true,
  "ready": true,
  "autoModel": "openrouter/auto",
  "policy": { "autoAllowed": ["anthropic/*", "openai/*", "google/*"], "autoCostTier": "medium" },
  "models": [
    {
      "id": "anthropic/claude-sonnet-5.5",
      "name": "Claude Sonnet 5.5",
      "vendor": "anthropic",
      "contextLength": 1000000,
      "inputCreditsPerMillion": 300,
      "outputCreditsPerMillion": 1500,
      "description": "…"
    }
  ]
}
CampoDescripción
platformtrue cuando la organización usa los modelos de la plataforma, cobrados en créditos. Si es false, la instalación usa claves propias de proveedor: consulta GET /api/providers.
autoModelEl ID de DoubleX Auto, que elige el modelo en cada mensaje.
policyLas familias y el rango de costo que DoubleX Auto puede usar, definidos por la organización en la pantalla Modelos.
models[].idEl valor que se usa en model en el Chat y en los disparadores.
models[].inputCreditsPerMillion, outputCreditsPerMillionPrecio en créditos por millón de tokens de entrada y de salida.

Para usar un modelo del catálogo en un agente, envía provider: "openrouter" y model con el ID del catálogo en el PATCH del agente, o usa doublex agents update <id> --model <id del catálogo>.

GET/api/providers#

En las instalaciones donde cada organización usa sus propias claves de proveedor, lista los proveedores, si cada uno está listo para ti y los modelos disponibles. Nunca devuelve las claves.

JSON
{
  "providers": [
    {
      "id": "anthropic",
      "label": "Anthropic",
      "ready": true,
      "scope": "organization",
      "models": [{ "id": "claude-sonnet-5-5", "label": "Claude Sonnet 5.5" }],
      "suggestedModels": []
    }
  ]
}

Usa el id del proveedor y el id del modelo juntos (anthropic/claude-sonnet-5-5) en el Chat y en los agentes.

GET/api/credits#

Saldo y consumo de créditos.

QueryDescripción
monthMes en formato AAAA-MM. Predeterminado: el mes actual.
agentSolo el consumo de un agente.
sourceSolo el consumo de un origen (por ejemplo, cli).
curl "https://doublex.ai/api/credits?month=2026-10" -H "Authorization: Bearer $DOUBLEX_API_KEY"
JSON
{
  "platform": true,
  "month": "2026-10",
  "balance": 48210,
  "spent": 1790,
  "byAgent": [{ "id": "agt_8f3a2b1c9d0e", "name": "Analista de CRM", "credits": 920, "count": 41 }],
  "bySource": [],
  "byModel": [],
  "daily": [],
  "entries": []
}
CampoDescripción
balanceSaldo actual de la organización.
spentCréditos consumidos en el período.
byAgent, bySource, byModel, dailyConsumo agrupado.
entriesMovimientos del período, 20 por página (parámetro page).

Los miembros ven solo su propio consumo; los administradores ven el de la organización. Si platform es false, la instalación no usa créditos. Los créditos solo se agregan desde la app, en Configuración › Uso y créditos.