Erreurs et limites
Les erreurs de la Gateway suivent le format de l'API OpenAI : le SDK OpenAI les lit comme celles d'OpenAI. Voici ce qu'elles veulent dire et comment repartir.
Les limites
| Limite | Valeur | Une fois atteinte |
|---|---|---|
| Appels par minute, clé « Script » | 300 par défaut | Attendre la minute suivante, puis réessayer |
| Appels par minute, clé « Développeur » | 600 par défaut | Attendre la minute suivante, puis réessayer |
| Dépense du mois, par personne | Fixée par votre organisation, ou aucune | Appels payants refusés jusqu'au 1er du mois suivant |
Le nombre d'appels se compte par minute d'horloge et par clé, sur tous les usages. La limite de dépense est décrite dans Administrer la Gateway.
Les erreurs
| Code | Message | Cause et solution |
|---|---|---|
400 | variable selon le paramètre | Requête invalide : un paramètre inconnu ou interdit, un flag de plus de 64 caractères, un sous-flag sans flag, un modèle de secours fermé ou identique au modèle principal. Le champ param de l'erreur dit lequel. |
401 | Incorrect API key provided. | Clé absente, mal copiée ou révoquée. Vérifiez la variable d'environnement, ou créez une nouvelle clé. |
403 | This gateway key is not allowed on this route. | Une clé « Script » utilisée par Claude Code ou Codex. Créez une clé « Développeur ». |
404 | The model `…` does not exist or you do not have access to it. | Modèle mal écrit, ou fermé pour votre organisation. Consultez la liste des modèles. |
429 | Rate limit reached for this gateway key. Retry after N seconds. | Trop d'appels dans la minute. Attendez le nombre de secondes indiqué (en-tête Retry-After), puis réessayez. |
429 | Monthly gateway spend limit reached. Ask an administrator of your organisation to raise it. | Votre limite de dépense du mois est atteinte. Ne réessayez pas : demandez à un administrateur de la relever. |
502 | The upstream provider returned an error. | Le fournisseur du modèle a échoué, ou a refusé la clé utilisée (celle de Supervise, ou celle de l'organisation si un administrateur en a connecté une : voir Vos propres clés). Réessayez plus tard, ou prévoyez un modèle de secours. |
503 | The gateway could not verify this request. Try again later. | Une vérification n'a pas pu se faire. L'appel est refusé par prudence : réessayez un peu plus tard. |
Avec Claude Code, la limite de dépense répond 400 au lieu de 429, pour que l'outil ne réessaie pas en boucle.
Distinguer les deux 429
Le SDK OpenAI les reconnaît à leur code :
rate_limit_exceeded: trop d'appels dans la minute. Attendre puis réessayer.insufficient_quota: limite de dépense atteinte. Ne pas réessayer.
Signaler un problème
Chaque réponse d'erreur porte un en-tête X-Request-Id. Donnez-le avec l'heure de l'appel : il permet de retrouver l'appel sans rien exposer de votre clé.