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=keyshows 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/tokenQGCLI uses this flow: qg login --device. You approve it at app.quebragalho.dev/connect/cli.