# Verificar créditos

`GET https://www.tryoncloud.com/api/v1/credits`

Devolve o número de «experiências» que a sua conta ainda pode realizar, a partir do mesmo conjunto de recursos que a chamada `POST /generate` utiliza.

## Pedido

```bash
curl https://www.tryoncloud.com/api/v1/credits -H "X-API-KEY: $TRYONCLOUD_API_KEY"
```

## Resposta

```json
{
  "credits_remaining": 4870,
  "purchased_remaining": 4870,
  "purchased_total": 5000,
  "free_remaining": 0,
  "spends_from": "purchased"
}
```

| Campo | Significado |
|---|---|
| `credits_remaining` | Experimentações que podes fazer agora mesmo. Usa esta aqui |
| `purchased_remaining` | Créditos adquiridos restantes (não têm prazo de validade) |
| `purchased_total` | Todos os créditos adquiridos até à data |
| `free_remaining` | Crédito gratuito restante (utilizável apenas antes da sua primeira compra) |
| `spends_from` | `purchased`, assim que tiver comprado créditos; caso contrário, `free_allowance` |

## Dicas

- Verifique antes de processar um lote grande e esteja atento caso o `credits_remaining` desça para um nível inferior a alguns dias de utilização.
- Limite de requisições: 60 por minuto por chave. Não o chame antes de cada tentativa; um código de erro `402` da API `/generate` já indica quando atingiu o limite.
- [Compre créditos](/pricing#developer-api) na página «Faturação» do painel de controlo.

## Erros

| HTTP | código | Significado |
|---|---|---|
| 401 | `NO_KEY`, `INVALID_KEY` | Chave em falta ou errada |
| 429 | `RATE_LIMITED` | Mais de 60 pedidos por minuto |
| 500 | `CREDITS_UNAVAILABLE` | Problema temporário, tente novamente |
