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"{
"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": "…"
}
]
}| Campo | Descrição |
|---|---|
platform | true 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. |
autoModel | O ID do DoubleX Auto, que escolhe o modelo a cada mensagem. |
policy | As famílias e a faixa de custo que o DoubleX Auto pode usar, definidas pela organização na tela Modelos. |
models[].id | O valor para usar em model no Chat e nos gatilhos. |
models[].inputCreditsPerMillion, outputCreditsPerMillion | Preç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.
{
"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.
| Query | Descrição |
|---|---|
month | Mês no formato AAAA-MM. Padrão: o mês atual. |
agent | Só o consumo de um agente. |
source | Só o consumo de uma origem (por exemplo, cli). |
curl "https://doublex.ai/api/credits?month=2026-10" -H "Authorization: Bearer $DOUBLEX_API_KEY"{
"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": []
}| Campo | Descrição |
|---|---|
balance | Saldo atual da organização. |
spent | Créditos consumidos no período. |
byAgent, bySource, byModel, daily | Consumo agrupado. |
entries | Lanç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.