DoubleX AgentesDocs

Referência da API › Recursos

Modelos e créditos

Catálogo de modelos com preço em créditos, provedores disponíveis, saldo e consumo da organização.

GET/api/models/catalog#

Catálogo dos modelos da plataforma, com o preço de cada um em 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": "…"
    }
  ]
}
CampoDescrição
platformtrue quando a organização usa os modelos da plataforma, cobrados em créditos. Se for false, a instalação usa chaves próprias de provedor: veja GET /api/providers.
autoModelO ID do DoubleX Auto, que escolhe o modelo a cada mensagem.
policyAs famílias e a faixa de custo que o DoubleX Auto pode usar, definidas pela organização na tela Modelos.
models[].idO valor para usar em model no Chat e nos gatilhos.
models[].inputCreditsPerMillion, outputCreditsPerMillionPreço em créditos por milhão de tokens de entrada e de saída.

Para usar um modelo do catálogo num agente, mande provider: "openrouter" e model com o ID do catálogo no PATCH do agente, ou use doublex agents update <id> --model <id do catálogo>.

GET/api/providers#

Nas instalações em que cada organização usa as próprias chaves de provedor, lista os provedores, se cada um está pronto para você e os modelos disponíveis. Nunca devolve as chaves.

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

Use id do provedor e id do modelo juntos (anthropic/claude-sonnet-5-5) no Chat e nos agentes.

GET/api/credits#

Saldo e consumo de créditos.

QueryDescrição
monthMês no formato AAAA-MM. Padrão: o mês atual.
agentSó o consumo de um agente.
sourceSó o consumo de uma origem (por exemplo, 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": []
}
CampoDescrição
balanceSaldo atual da organização.
spentCréditos consumidos no período.
byAgent, bySource, byModel, dailyConsumo agrupado.
entriesLançamentos do período, 20 por página (parâmetro page).

Membros veem só o próprio consumo; administradores veem o da organização. Se platform for false, a instalação não usa créditos. Créditos só são adicionados pelo app, em Configurações › Uso e créditos.