Vue d’ensemble
L’utilisation de l’API est soumise à des limites de débit. Ces limites restreignent les requêtes, les tokens ou d’autres formes d’utilisation sur une période donnée.
Une réponse 429 peut indiquer une limite de débit temporaire, un solde prépayé épuisé ou une limite de dépenses ou d’utilisation. Vérifiez les détails de l’erreur avant de réessayer ou de modifier vos paramètres de facturation.
Identifiez la cause
Lisez le message d’erreur et la valeur error.code, si elle est fournie. Les erreurs liées à la facturation peuvent néanmoins utiliser la valeur plus générale insufficient_quota pour error.type.
| Erreur ou code | Signification | Mesure à prendre |
| Limite de débit atteinte pour les requêtes ou les tokens | Les requêtes dépassent une limite de débit applicable. | Espacez les requêtes et suivez les conseils ci-dessous pour les nouvelles tentatives. |
| credit_balance_exhausted | L’organisation n’a plus de crédits prépayés. | Ajoutez des crédits dans vos paramètres de facturation de l’API. |
| organization_usage_limit_exceeded | L’organisation a atteint la limite d’utilisation qui lui a été attribuée par OpenAI. | Demandez une augmentation de la limite d’utilisation autorisée. |
| organization_spend_limit_exceeded | L’organisation a atteint sa limite de dépenses contraignante. | Augmentez ou supprimez la limite, ou attendez la réinitialisation mensuelle. |
| project_spend_limit_exceeded | Le projet a atteint sa limite de dépenses contraignante. | Augmentez ou supprimez la limite du projet, ou attendez la réinitialisation mensuelle. |
Réessayer après une erreur de facturation, de dépenses ou de quota ne rétablit pas l’accès. Résolvez d’abord le problème de solde ou de limite signalé. Les modifications des limites de dépenses contraignantes peuvent prendre du temps à s’appliquer.
La modification d’une limite de dépenses nécessite l’autorisation de gérer les paramètres de l’organisation ou du projet concernés. Si vous n’y avez pas accès, contactez la personne qui gère ces paramètres.
Pour l’achat de crédits prépayés, consultez : Configurer et gérer la facturation prépayée de l’API.
Pour connaître les différents contrôles des dépenses, consultez le guide des limites de dépenses de l’API.
Vérifiez les limites de débit applicables
Accédez à la page Limites de votre organisation pour consulter son niveau d’utilisation et ses limites actuels.
Les limites de débit peuvent s’appliquer au niveau de l’organisation et du projet. Il ne s’agit pas de quotas individuels par utilisateur. Les limites varient également selon le modèle, et certaines familles de modèles partagent une même limite.
Vérifiez quelle limite est indiquée par l’erreur. Par exemple, les requêtes par minute et les tokens par minute constituent des limites distinctes. Vous pouvez atteindre l’une tout en restant en dessous de l’autre.
Vérifiez les limites de l’API de génération d’images
Les limites de débit de l’API de génération d’images dépendent du modèle et de votre niveau d’utilisation. Sélectionnez votre modèle sur la page des modèles pour consulter ses limites.
Pour les instructions de configuration, consultez le guide de génération d’images pour les développeurs. Pour en savoir plus sur les niveaux d’utilisation, consultez le guide des limites de débit de l’API.
Vérifiez l’organisation utilisée par votre requête
Si vous appartenez à plusieurs organisations, vérifiez que vos requêtes utilisent l’organisation et le projet souhaités.
Lorsque votre clé API utilise une organisation par défaut, vérifiez le paramètre d’organisation par défaut. Les modalités de facturation et les niveaux d’utilisation peuvent varier d’une organisation à l’autre.
Réduisez les erreurs temporaires liées aux limites de débit
Espacez les requêtes et évitez les envois en rafale
Répartissez les requêtes dans le temps au lieu d’en envoyer un grand nombre à la fois.
Les limites de débit peuvent être appliquées sur des périodes plus courtes que l’intervalle affiché. Par exemple, une limite de 60 requêtes par minute peut aussi être appliquée sur des périodes d’une seconde. Une brève rafale de requêtes peut donc déclencher une erreur, même si votre utilisation moyenne semble inférieure à la limite par minute.
Des prompts longs et des plafonds de tokens de sortie inutilement élevés peuvent aussi contribuer aux erreurs de débit de tokens.
Réessayez après un délai
En cas d’erreur temporaire liée aux limites de débit :
Vérifiez la présence d’un en-tête de réponse Retry-After.
Si cet en-tête contient un délai valide, attendez au moins cette durée avant de réessayer.
Si l’en-tête est absent ou non valide, utilisez un délai exponentiel avec variation aléatoire : augmentez le délai après chaque tentative infructueuse et ajoutez un court délai aléatoire.
Limitez à la fois le nombre de nouvelles tentatives et le temps total qui leur est consacré.
Les SDK officiels d’OpenAI réessaient déjà les requêtes en cas d’erreurs de limite de débit admissibles et respectent Retry-After lorsqu’il est présent. Tenez compte de ces tentatives avant d’ajouter une autre boucle de nouvelles tentatives.
Les requêtes infructueuses sont comptabilisées dans les limites par minute. Renvoyer continuellement la même requête peut prolonger le problème.
Pour des conseils de mise en œuvre et des exemples, consultez le guide des limites de débit de l’API. Examinez toute bibliothèque tierce de gestion des nouvelles tentatives avant de l’utiliser dans votre application.
Vérifiez la taille du prompt et de la sortie
Supprimez de vos prompts les instructions inutiles, le contexte répété et les exemples superflus. Testez le prompt modifié pour vérifier qu’il produit toujours le résultat souhaité.
Utilisez le paramètre de tokens de sortie pris en charge par votre point de terminaison et votre modèle :
Chat Completions utilise max_completion_tokens.
Responses utilise max_output_tokens.
Évitez de définir un plafond bien supérieur aux besoins de la requête. Ces paramètres incluent les tokens de raisonnement ainsi que la sortie visible : prévoyez donc une marge pour les deux lorsque vous utilisez un modèle de raisonnement.
Vérifiez votre niveau d’utilisation
Si les erreurs persistent après avoir réduit les envois en rafale et vérifié l’utilisation des tokens, consultez votre page Limites pour connaître les moyens d’augmenter vos limites.
Le niveau d’utilisation payante de votre organisation augmente automatiquement lorsque le total de ses achats de crédits atteint les seuils Build, Launch et Grow. Les niveaux supérieurs offrent généralement des limites de débit plus élevées. Consultez le guide des limites de débit de l’API pour connaître les conditions d’accès aux différents niveaux.
Votre limite d’utilisation mensuelle autorisée est distincte des limites de débit des requêtes et des tokens. L’augmentation de l’une ne doit pas être considérée comme la confirmation que l’autre a changé.
Si le problème persiste
Avant de contacter l’assistance
Gardez à disposition le message d’erreur exact, tout code d’erreur, les identifiants des requêtes concernées, l’heure de l’erreur avec votre fuseau horaire et la limite concernée affichée dans votre compte. Notez les mesures que vous avez déjà essayées.
Contactez l’assistance OpenAI
Contactez l’assistance OpenAI via le centre d’aide si vous ne parvenez pas à résoudre le problème après avoir vérifié la limite signalée. Ne communiquez pas de clés API ni d’autres secrets d’authentification.