Skip to content
quebragalho/docs

API reference

Models

GET/v1/models

The models your API key can use, with pricing and specs. Use the exact id in the model field.

The catalog your key sees

Query it with the key you will use. A key can have its own model list, and the response comes already filtered by it.

cURL
curl https://api.quebragalho.dev/v1/models \  -H "Authorization: Bearer $QUEBRAGALHO_API_KEY"

Each model includes your plan's price in USD and BRL, the flash sale when one is active, whether it accepts bonus balance, and its specs: context, max output, tools, vision and reasoning. Anything the specs do not report yet comes as null.

Use the exact id

  • The model field takes the id as it appears in the list, with no provider prefix.
  • An id outside the catalog returns 404 model_not_found.
  • A key with its own list rejects the other models with 403 model_not_allowed.
  • Some models only accept topped-up balance. Without a top-up that covers the hold, the request returns 402 insufficient_paid_balance.