OpenAI „You exceeded your current quota“ (insufficient_quota)

Dies ist der 429-Fehler, den Backoff nicht beheben kann. insufficient_quota bedeutet, dass dein Konto kein ausgabefähiges Guthaben hat – die Anfrage wurde abgelehnt, bevor ein Modell ausgeführt wurde, und wird weiterhin abgelehnt, bis sich die Abrechnung ändert. So bestätigst du, in welchem Abrechnungsstatus du dich befindest, und behebst ihn innerhalb weniger Minuten.

Der Fehler

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"
  }
}

Ursachen und Lösungen im Überblick

Ursache	Lösung
Guthaben für vorausbezahlte Credits ist 0 $	Die API ist vorausbezahlt: Kaufe Credits (oder aktiviere die automatische Aufladung) unter Settings → Billing. Eine gespeicherte Karte allein fügt kein Guthaben hinzu, solange keine Credits gekauft werden.
Credits des kostenlosen Testzeitraums abgelaufen oder aufgebraucht	Testguthaben verfällt normalerweise nach 3 Monaten, auch wenn es nicht genutzt wurde. Die Lösung ist dieselbe: Füge eine Zahlungsmethode hinzu und kaufe Credits.
Monatliches Budgetlimit erreicht	Ein von dir unter Limits festgelegtes Budget blockiert Anfragen für den Rest des Monats, sobald es erreicht ist. Erhöhe es oder warte, bis der neue Monat beginnt.
Der Schlüssel gehört zu einem Projekt oder einer Organisation ohne Budget	sk-proj- Schlüssel geben ihr Geld aus dem jeweiligen Projekt aus; ein Projekt kann ein eigenes, niedrigeres Limit als die Organisation haben. Prüfe das Projekt des Schlüssels im Dashboard, nicht nur die Gesamtsumme der Organisation.

Bestätige, dass es sich um ein Kontingent und nicht um eine Ratenbegrenzung handelt

Lies error.type. rate_limit_exceeded verschwindet innerhalb einer Minute von selbst und rechtfertigt Backoff; insufficient_quota verschwindet nicht von selbst, und eine Wiederholung ist reine Geräuschentwicklung. Wenn du unsicher bist, klärt eine Wiederholung nach 60 Sekunden die Sache: Bleibt die Antwort 429 mit derselben Meldung, handelt es sich um die Abrechnung.

Prüfe das Guthaben, aus dem der Schlüssel tatsächlich Ausgaben tätigt

Öffne platform.openai.com → Settings → Billing und prüfe das Guthaben. Bei null oder einem negativen Wert: Kaufe Credits. Prüfe anschließend unter Settings → Limits die monatliche Budgetgrenze und – bei sk-proj- Schlüsseln – die eigenen Nutzungslimits des zuständigen Projekts. Alle drei können diesen Fehler unabhängig voneinander verursachen.

Behebe die wiederkehrende Ursache, nicht nur den Vorfall

Aktiviere eine automatische Aufladung mit einem sinnvollen Schwellenwert, damit ein geschäftiges Wochenende nicht die Produktion lahmlegt, und setze den Budgetalarm (nicht nur die harte Grenze), damit du von sich nähernden Limits erfährst, bevor Anfragen fehlschlagen.

Wenn Sie Kunavo verwenden

Kunavo verwendet dasselbe Vorauszahlungsmodell. Der ehrliche Vergleich betrifft daher die Reichweite des Guthabens, nicht den Mechanismus: Ein Kunavo-Guthaben deckt GPT und Claude gemeinsam ab, wird pro Token berechnet, und fehlgeschlagene Anfragen werden nie abgerechnet. Wenn Kunavos eigenes Guthaben leer ist, erhältst du einen 402 mit dem Code insufficient_quota (absichtlich derselbe Code, sodass die Fehlerbehandlung des OpenAI-SDKs übernommen werden kann) – eine Aufladung hebt den Fehler sofort auf, ohne monatliche Limits, die erst zurückgesetzt werden müssten. Planst du das Budget für die Lösung? Die aktuellen GPT-Preise pro Token sowie OpenAIs offizielle Liste neben unseren Preisen findest du in der GPT-API-Preisliste.

Häufig gestellte Fragen

Ich habe eine Kreditkarte hinzugefügt – warum erhalte ich weiterhin insufficient_quota?

Weil die API vorausbezahlte Credits verwendet und nicht direkt die Karte belastet. Das Hinzufügen einer Karte ermöglicht nur den Kauf; du musst weiterhin Credits kaufen oder die automatische Aufladung aktivieren. Der Fehler verschwindet innerhalb von ein bis zwei Minuten, nachdem das Guthaben positiv geworden ist.

Behebt sich insufficient_quota jemals von selbst?

Nur in einem Fall: bei einer monatlichen Budgetgrenze, die sich mit Beginn des neuen Monats zurücksetzt. Fälle mit null Guthaben und abgelaufenem Testzeitraum bestehen weiter, bis du Credits kaufst. In beiden Fällen helfen Wiederholungsschleifen nicht – die Anfrage wird abgelehnt, bevor ein Modell ausgeführt wird.

Kosten die fehlgeschlagenen 429-Anfragen etwas?

Nein – OpenAI lehnt sie vor der Inferenz ab, und auch bei Kunavo werden fehlgeschlagene Anfragen nie berechnet. Die Kosten entstehen durch den Ausfall. Deshalb sind automatische Aufladung und Budgetalarm besser als eine alleinige harte Grenze.

OpenAI „You exceeded your current quota“ (insufficient_quota) – warum Warten nie hilft