> Índice: https://quebragalho.dev/docs/llms.txt

# 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**

```bash
# saldo disponível: recarregado + bônus
curl https://api.quebragalho.dev/v1/balance \
  -H "Authorization: Bearer $QUEBRAGALHO_API_KEY"

# esta key: plano e modelos
curl https://api.quebragalho.dev/v1/key \
  -H "Authorization: Bearer $QUEBRAGALHO_API_KEY"

# consumo desta key
curl -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**

```http
# 1 · o terminal pede um código
POST https://app.quebragalho.dev/api/cli/v1/auth/device/code
# 2 · e consulta até você aprovar
POST 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](https://app.quebragalho.dev/connect/cli).

Versão para ler no navegador: https://quebragalho.dev/docs/api/conta
