Skip to content
quebragalho/docs

API reference

Account API

Balance, API key details and usage with the same key you use for inference. It is what a CLI uses to show how much balance is left and how much has been spent.

Balance, key and usage with the same key

The key that runs inference also reads the account data.

cURL
# available balance: topped-up + bonuscurl https://api.quebragalho.dev/v1/balance \  -H "Authorization: Bearer $QUEBRAGALHO_API_KEY"# this key: plan and modelscurl https://api.quebragalho.dev/v1/key \  -H "Authorization: Bearer $QUEBRAGALHO_API_KEY"# usage of this keycurl -G https://api.quebragalho.dev/v1/usage \  -d scope=key \  -H "Authorization: Bearer $QUEBRAGALHO_API_KEY"
GET /v1/balance
Balance available right now, split into topped-up balance (default) and bonus.
GET /v1/key
Key name, plan and enabled models. It does not include the person's email or name.
GET /v1/usage
Requests and input, output and cache tokens per period, in windows of up to 31 days. scope=key shows only this key; the default is the whole account.

Up to 60 reads per minute per key. Above that, the response is 429 with Retry-After.

Sign in without copying the key

CLIs and integrations can sign in without you copying and pasting a key. The terminal shows a code, you approve it at /connect/cli and the program gets its own API key. It shows up under API keys with the "via CLI" badge, and you can revoke it there at any time.

Device flow
# 1 · the terminal asks for a codePOST https://app.quebragalho.dev/api/cli/v1/auth/device/code# 2 · and polls until you approvePOST https://app.quebragalho.dev/api/cli/v1/auth/device/token

QGCLI uses this flow: qg login --device. You approve it at app.quebragalho.dev/connect/cli.