Pular para o conteúdo
quebragalho/docs

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=key mostra 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/token

O QGCLI usa este fluxo: qg login --device. A aprovação acontece em app.quebragalho.dev/connect/cli.