Referência da API
Conta pela API
Saldo, dados da key e consumo com a mesma key da inferência. É o que um CLI usa para mostrar quanto saldo sobra e quanto já foi gasto.
Saldo, key e consumo com a mesma key
A key que faz a inferência também lê os dados da conta.
cURL
# saldo disponível: recarregado + bônuscurl https://api.quebragalho.dev/v1/balance \ -H "Authorization: Bearer $QUEBRAGALHO_API_KEY"# esta key: plano e modeloscurl https://api.quebragalho.dev/v1/key \ -H "Authorization: Bearer $QUEBRAGALHO_API_KEY"# consumo desta keycurl -G https://api.quebragalho.dev/v1/usage \ -d scope=key \ -H "Authorization: Bearer $QUEBRAGALHO_API_KEY"GET /v1/balance- Saldo disponível agora, separado em saldo recarregado (
default) e bônus. GET /v1/key- Nome da key, plano e modelos liberados. Não traz e-mail nem nome da pessoa.
GET /v1/usage- Pedidos e tokens de entrada, saída e cache por período, em janelas de até 31 dias.
scope=keymostra só esta key; o padrão é a conta toda.
Até 60 leituras por minuto por key. Acima disso, a resposta é 429 com Retry-After.
Entrar sem copiar a key
CLIs e integrações podem entrar sem você copiar e colar uma key. O terminal mostra um código, você aprova em /connect/cli e o programa recebe uma API key própria. Ela aparece em API keys com o selo "via CLI" e pode ser revogada por lá a qualquer momento.
Device flow
# 1 · o terminal pede um códigoPOST https://app.quebragalho.dev/api/cli/v1/auth/device/code# 2 · e consulta até você aprovarPOST https://app.quebragalho.dev/api/cli/v1/auth/device/tokenO QGCLI usa este fluxo: qg login --device. A aprovação acontece em app.quebragalho.dev/connect/cli.