OpenAI « You exceeded your current quota » (insufficient_quota) — pourquoi attendre ne résout jamais le problème

C’est le 429 que le backoff ne peut pas résoudre. insufficient_quota signifie que votre compte ne dispose d’aucun crédit utilisable — la requête a été rejetée avant l’exécution d’un modèle et continuera de l’être jusqu’à une modification de la facturation. Voici comment confirmer votre état de facturation et le résoudre en quelques minutes.

L’erreur

response (HTTP 429)

{
  "error": {
    "message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, read the docs: https://platform.openai.com/docs/guides/error-codes/api-errors.",
    "type": "insufficient_quota",
    "param": null,
    "code": "insufficient_quota"
  }
}

Causes et solutions en bref

Cause	Solution
Le solde de crédits prépayés est de $0	L’API est prépayée : achetez des crédits (ou activez la recharge automatique) dans Settings → Billing. Une carte enregistrée seule n’ajoute rien tant que vous n’avez pas acheté de crédits.
Les crédits d’essai gratuit ont expiré ou ont été utilisés	Les crédits d’essai expirent (généralement après 3 mois), même s’ils n’ont pas été utilisés. La solution est la même : ajoutez un moyen de paiement et achetez des crédits.
La limite budgétaire mensuelle a été atteinte	Un budget que vous avez défini vous-même dans Limits bloque les requêtes jusqu’à la fin du mois une fois atteint. Augmentez-le ou attendez le début du mois suivant.
La clé appartient à un projet ou à une organisation sans budget	Les clés sk-proj- dépensent le budget de leur projet ; un projet peut avoir sa propre limite (inférieure) à celle de l’organisation. Vérifiez le projet de la clé dans le tableau de bord, et pas seulement le total de l’organisation.

Confirmer qu’il s’agit d’un quota et non d’une limitation de débit

Lisez error.type. rate_limit_exceeded se résout de lui-même en moins d’une minute et justifie un backoff ; insufficient_quota ne se résout jamais seul et le réessayer ne fait qu’ajouter du bruit. En cas de doute, une nouvelle tentative après 60 secondes suffit : si le même message 429 apparaît encore, il s’agit de la facturation.

Vérifier le solde de crédits réellement utilisé par la clé

Dans platform.openai.com → Settings → Billing, consultez le solde de crédits. Zéro ou négatif : achetez des crédits. Vérifiez ensuite Settings → Limits pour le plafond budgétaire mensuel et, pour les clés sk-proj-, les limites d’utilisation propres au projet propriétaire. Ces trois éléments peuvent indépendamment produire cette erreur.

Éliminer la récurrence, pas seulement l’incident

Activez la recharge automatique avec un seuil raisonnable afin qu’un week-end chargé ne mette pas la production à l’arrêt, et définissez l’alerte budgétaire (pas seulement le plafond strict) pour être informé de l’approche des limites avant que les requêtes ne commencent à échouer.

Si vous appelez via Kunavo

Kunavo utilise le même modèle prépayé ; la comparaison honnête porte donc sur la portée de l’impact du portefeuille, et non sur le mécanisme : un solde Kunavo couvre GPT et Claude ensemble, avec une tarification au token, et les requêtes échouées ne sont jamais facturées. Lorsque le portefeuille Kunavo est épuisé, vous obtenez un 402 avec le code insufficient_quota (volontairement le même code, afin que la gestion des erreurs du SDK OpenAI soit réutilisable) — un rechargement le résout instantanément, sans plafond mensuel à débloquer. Vous budgétisez la solution ? Les tarifs GPT actuels par token, avec la liste officielle d’OpenAI à côté des nôtres, sont disponibles dans la liste des tarifs de l’API GPT.

Questions fréquentes

J’ai ajouté une carte bancaire — pourquoi est-ce que je reçois toujours insufficient_quota ?

Parce que l’API utilise des crédits prépayés, et non la carte directement. Ajouter une carte permet uniquement d’acheter ; vous devez encore acheter des crédits ou activer la recharge automatique. L’erreur disparaît dans la minute ou les deux minutes suivant le passage du solde en positif.

insufficient_quota se résout-il parfois de lui-même ?

Dans un seul cas : un plafond budgétaire mensuel, qui est réinitialisé au changement de mois. Les cas de solde nul et d’essai expiré persistent jusqu’à l’achat de crédits. Dans tous les cas, les boucles de nouvelles tentatives n’aident pas : la requête est rejetée avant l’exécution d’un modèle.

Les requêtes 429 échouées coûtent-elles quelque chose ?

Non — OpenAI les rejette avant l’inférence, et sur Kunavo les requêtes échouées ne sont jamais facturées non plus. Le coût est l’interruption de service ; c’est pourquoi la recharge automatique associée à une alerte budgétaire est préférable à un plafond strict seul.

Guides associés

La sémantique détaillée des erreurs est disponible dans référence des erreurs ; obtenir une clé prend une minute via inscription et la guide d’authentification.