# Gestion des erreurs

> Tchavi renvoie des codes de statut HTTP standards accompagnés d'un corps JSON d'erreur structuré.

- Canonical: https://tchavi.com/fr/docs/errors

---


Tchavi renvoie des codes de statut HTTP standards. Les erreurs incluent un corps JSON :

```json
{
  "error": {
    "code": "insufficient_credits",
    "message": "You don't have enough credits for this request.",
    "status": 402
  }
}
```

## Codes d'erreur courants

| Status | Code                     | Description                                                                         |
| ------ | ------------------------ | ----------------------------------------------------------------------------------- |
| 401    | invalid_api_key          | Clé API manquante ou invalide                                                       |
| 402    | insufficient_credits     | Crédits insuffisants — rechargez pour continuer                                     |
| 403    | model_not_allowed        | Votre palier de compte n'inclut pas ce modèle                                       |
| 429    | rate_limit_exceeded      | Limite RPM atteinte — vérifiez l'en-tête Retry-After                                |
| 429    | user_rate_limit_exceeded | Limite RPM par utilisateur atteinte — passez à un palier supérieur pour l'augmenter |
| 429    | tpm_rate_limit_exceeded  | Limite de tokens par minute atteinte — patientez avant de réessayer                 |
| 500    | internal_error           | Erreur serveur — réessayez ou contactez le support                                  |
| 502    | upstream_error           | Le fournisseur d'IA est temporairement indisponible                                 |

Voir aussi [Limites de débit](/fr/docs/rate-limits) et [Crédits et facturation](/fr/docs/credits).