Erreurs

HTTP	Signification	Action recommandée
400	Demande invalide	Corriger le JSON et les champs obligatoires
401	Clé invalide, gelée ou révoquée	Faire pivoter ou débloquer la clé
402	Solde du compte insuffisant ou limite d'utilisation des clés atteinte	Ajoutez des fonds ou réinitialisez/augmentez la limite clé
403	Modèle indisponible pour la clé ou l'adresse IP source rejetée par une liste d'autorisation d'API	Mettez à jour les autorisations de clé ou utilisez une adresse IP source autorisée
404	Point de terminaison, modèle ou demande asynchrone inconnu	Vérifiez l'identifiant et le chemin
413	Demande trop volumineuse	Réduire la taille du contexte
429	RPM ou simultanéité dépassée	Honneur Retry-After
500	Erreur de passerelle	Réessayez et inspectez les journaux
502/503/504	L'amont n'est pas disponible ou a expiré	Réessayez avec une interruption exponentielle

Paiement requis

Un solde d'entreprise/compte insuffisant renvoie HTTP 402 Payment Required dans l'enveloppe compatible OpenAI :

{
  "error": {
    "message": "Insufficient account balance.",
    "type": "payment_required",
    "code": "insufficient_balance"
  }
}

Le même motif/code stable est enregistré dans l’historique des demandes. UN 402 La demande est rejetée avant l'exécution du fournisseur et ne doit pas être automatiquement réessayée tant que le financement ou la contrainte de dépenses applicable n'a pas été corrigé.

Rejet de la liste d'autorisation IP

Lorsqu'une clé API authentifiée est valide mais que l'adresse source se trouve en dehors de la liste autorisée de l'API personnelle ou professionnelle, Model Gate rejette la demande avant l'exécution en amont. Les réponses compatibles OpenAI utilisent HTTP 403 avec code ip_not_allowed. Les réponses compatibles avec Anthropic utilisent l'enveloppe d'erreur Anthropic avec HTTP 403 et authentication_error. Ne réessayez pas à partir de la même source non autorisée ; modifiez la liste blanche configurée ou envoyez la demande à partir d'une adresse autorisée.

Réessayer 429 après Retry-After. Réessayer 500, 502, 503, et 504 jusqu'à trois fois avec un intervalle de 1/2/4 seconde. Ne réessayez pas automatiquement la validation, l'authentification, le solde ou les erreurs introuvables.

Utilisez l'ID public de la demande de X-Request-ID corréler la réponse avec le journal des demandes.