# Controlla i crediti

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

Restituisce il numero di prove che il tuo account può ancora effettuare, attingendo dallo stesso pool da cui attinge il metodo `POST /generate`.

## Richiesta

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

## Risposta

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

| Campo | Significato |
|---|---|
| `credits_remaining` | Prova subito queste opzioni. Usa questa |
| `purchased_remaining` | Crediti acquistati rimanenti (non scadono mai) |
| `purchased_total` | Tutti i crediti acquistati in passato |
| `free_remaining` | Credito gratuito residuo (utilizzabile solo prima del primo acquisto) |
| `spends_from` | `purchased` una volta acquistati i crediti, altrimenti `free_allowance` |

## Consigli

- Controlla prima di eseguire un’elaborazione su larga scala e imposta un avviso quando `credits_remaining` scende al di sotto di pochi giorni di utilizzo.
- Limite di richieste: 60 richieste al minuto per chiave. Non effettuare la chiamata prima di ogni prova; un codice di errore `402` da `/generate` ti avvisa già quando hai esaurito il limite.
- [Acquista crediti](/pricing#developer-api) dalla pagina "Fatturazione" della dashboard.

## Errori

| HTTP | codice | Significato |
|---|---|---|
| 401 | `NO_KEY`, `INVALID_KEY` | Chiave mancante o errata |
| 429 | `RATE_LIMITED` | Oltre 60 richieste al minuto |
| 500 | `CREDITS_UNAVAILABLE` | Problema temporaneo, riprova |
