DoubleX AgentesDocs

API reference › Resources

Models and credits

Model catalog with prices in credits, available providers, and the organization's balance and usage.

GET/api/models/catalog#

The platform's model catalog, with each model's price in credits.

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": "…"
    }
  ]
}
FieldDescription
platformtrue when the organization uses the platform's models, billed in credits. If it's false, the installation uses its own provider keys: see GET /api/providers.
autoModelThe ID of DoubleX Auto, which picks the model for each message.
policyThe model families and cost tier DoubleX Auto can use, set by the organization on the Models page.
models[].idThe value to use in model in Chat and in triggers.
models[].inputCreditsPerMillion, outputCreditsPerMillionPrice in credits per million input and output tokens.

To use a catalog model in an agent, send provider: "openrouter" and model with the catalog ID in the agent PATCH, or use doublex agents update <id> --model <catalog id>.

GET/api/providers#

On installations where each organization uses its own provider keys, lists the providers, whether each one is ready for you, and the available models. It never returns the keys.

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

Use the provider id and the model id together (anthropic/claude-sonnet-5-5) in Chat and in agents.

GET/api/credits#

Credit balance and usage.

QueryDescription
monthMonth in YYYY-MM format. Default: the current month.
agentOnly one agent's usage.
sourceOnly usage from one source (for example, 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": "CRM Analyst", "credits": 920, "count": 41 }],
  "bySource": [],
  "byModel": [],
  "daily": [],
  "entries": []
}
FieldDescription
balanceThe organization's current balance.
spentCredits used in the period.
byAgent, bySource, byModel, dailyGrouped usage.
entriesLedger entries for the period, 20 per page (page parameter).

Members see only their own usage; admins see the whole organization's. If platform is false, the installation doesn't use credits. Credits can only be added in the app, in Settings › Usage and credits.