# Consulter le générique

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

Renvoie le nombre d'essais dont dispose encore votre compte, à prélever sur le même pool que celui utilisé par la requête `POST /generate`.

## Demande

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

## Réponse

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

| Champ | Signification |
|---|---|
| `credits_remaining` | Des simulations que vous pouvez lancer dès maintenant. Utilisez celle-ci |
| `purchased_remaining` | Crédits achetés restants (ils n'expirent jamais) |
| `purchased_total` | Tous les crédits achetés à ce jour |
| `free_remaining` | Crédit gratuit restant (utilisable uniquement avant votre premier achat) |
| `spends_from` | `purchased` une fois que vous avez acheté des crédits, sinon `free_allowance` |

## Conseils

- Vérifiez avant de lancer un traitement volumineux et recevez une alerte lorsque `credits_remaining` passe en dessous d'un nombre de jours d'utilisation.
- Limite de requêtes : 60 requêtes par minute et par clé. Ne l'appelez pas avant chaque essai ; un code d'erreur `402` renvoyé par `/generate` vous indique déjà que vous avez atteint la limite.
- [Achetez des crédits](/pricing#developer-api) depuis la page « Facturation » du tableau de bord.

## Erreurs

| HTTP | code | Signification |
|---|---|---|
| 401 | `NO_KEY`, `INVALID_KEY` | Clé manquante ou erronée |
| 429 | `RATE_LIMITED` | Plus de 60 requêtes par minute |
| 500 | `CREDITS_UNAVAILABLE` | Problème temporaire, veuillez réessayer |
