Dépannage des requêtes

Erreur 429 d’API d’IA : limites de requêtes, crédits et plafonds de dépenses

Un 429 est une réponse indiquant une limite de requêtes, pas une preuve de panne du fournisseur. Consultez le code d’erreur, le message et les en-têtes de nouvelle tentative du fournisseur avant de réessayer.

Réponse rapide

Un 429 est une réponse indiquant une limite de requêtes, pas une preuve de panne du fournisseur. Consultez le code d’erreur, le message et les en-têtes de nouvelle tentative du fournisseur avant de réessayer.

Ce que chaque fournisseur documente

OpenAI distingue limites de fréquence de requêtes, crédits épuisés et limites d’organisation ou de projet. Examinez error.code ; réessayer après une limite de facturation ou d’usage ne rétablit pas l’accès.

Claude utilise rate_limit_error pour les limites de requêtes et certains plafonds de dépenses. Une réponse liée au plafond de dépenses du niveau d’utilisation ne comporte pas d’en-tête retry-after. Une croissance rapide du trafic peut également déclencher des limites de requêtes.

Gemini inclut 429 RESOURCE_EXHAUSTED parmi les erreurs pouvant justifier un recul exponentiel. Examinez les détails de l’erreur avant de considérer une limite comme transitoire.

Réponse recommandée de l’application

Réduisez la concurrence des requêtes pour une limite transitoire, respectez le délai de nouvelle tentative fourni et fixez un nombre maximal de tentatives et un délai total. Tenez compte des tentatives déjà effectuées par votre SDK. L’absence d’en-tête de nouvelle tentative n’identifie pas à elle seule la cause.

Conservez un corps d’erreur expurgé des données sensibles et l’identifiant de requête. Vérifiez en privé la configuration de votre compte lorsque l’erreur indique une limite de crédits ou de dépenses ; ne publiez pas d’identifiants secrets. Comparez le périmètre d’état API pertinent aux éléments de votre requête.

Pages de services associés

Chaque entrée indique sa propre couverture de collecte. Un service lié n’est pas nécessairement collecté automatiquement.

La date de vérification éditoriale concerne ce guide. Les heures de collecte des rapports actuels figurent sur les pages des services.