Individuelles AngebotKurze Anfrage senden: Antwort am selben Tag, schriftliches Angebot spätestens nach 1 WerktagAntwort am selben Tag · Angebot in 1 WerktagAngebot anfordern
Künstliche Intelligenz

OpenAI API Fehler 429: Rate Limit und insufficient_quota lösen

Talha Aslan 17 Minuten Lesezeit 3 Aufrufe

Was bedeutet der OpenAI API Fehler 429 und was tun Sie zuerst?

Der OpenAI API Fehler 429 bedeutet, dass der Server Ihre Anfrage verstanden und bewusst abgelehnt hat. Dahinter stehen zwei getrennte Ursachen: Sie haben in kurzer Zeit zu viele Anfragen oder Token gesendet (Rate Limit), oder Guthaben, Ausgabenlimit oder Nutzungskontingent sind aufgebraucht (Quota). Lesen Sie also zuerst den Fehlercode im Antworttext.

Bleiben Sie ruhig, denn ein OpenAI API Fehler 429 heißt selten, dass Ihr Schlüssel defekt ist. Denn der Code zeigt Ihnen die Richtung. Ein Rate Limit löst sich dann, wenn Sie langsamer werden und warten. Ein Kontingentproblem löst sich dagegen nicht durch Warten, daher müssen Sie in der Abrechnung handeln.

Diese Anleitung folgt der Diagnosereihenfolge, die wir in der Praxis nutzen. Prüfen Sie zunächst die wahrscheinlichste Ursache, weil dort die meisten Probleme liegen. Danach gehen Sie zu den selteneren Ursachen über. Das heißt, wer der Reihe nach vorgeht, spart mehr Zeit als beim Ausprobieren von Einstellungen.

Wie sieht die Schnelllösung beim OpenAI API Fehler 429 aus?

Die folgende Liste läuft von der wahrscheinlichsten zur unwahrscheinlichsten Ursache. Schließen Sie jeden Schritt ab und prüfen Sie das Ergebnis, bevor Sie weitergehen. Somit erkennen Sie genau, welche Änderung geholfen hat.

  1. Lesen Sie die Felder error.code und error.type im Antworttext. Sie zeigen also, ob es um ein Rate Limit oder um Guthaben geht.
  2. Verweist der Code auf Guthaben, Ausgabenlimit oder Nutzungslimit, öffnen Sie die Abrechnungseinstellungen. Prüfen Sie dann Guthaben, monatliches Ausgabenlimit und Projektlimit.
  3. Bei einem Rate Limit senken Sie die Anfragegeschwindigkeit. Gibt es einen Retry-After Header, warten Sie mindestens so lange.
  4. Fügen Sie der Wartezeit danach eine kleine zufällige Zeit hinzu und begrenzen Sie die Zahl der Versuche.
  5. Prüfen Sie, was andere Anwendungen und Kollegen in derselben Organisation tun. Das Limit teilen nämlich alle, daher zählt auch fremde Nutzung.
  6. Außerdem setzen Sie max_tokens nahe an die erwartete Antwortgröße und kürzen Sie den Prompt.
  7. Verschieben Sie nicht dringende Aufgaben in eine Warteschlange oder in die Stapelverarbeitung.
  8. Hilft das dennoch nicht, prüfen Sie Ihre Nutzungsstufe und die offiziellen Wege zur Limiterhöhung.

Hinweis: Limitwerte unterscheiden sich je nach Modell und Konto. Lesen Sie aktuelle Werte auf der Limitseite Ihres OpenAI Dashboards, denn wir nennen hier keine Zahlen.

Warum versteckt ein Statuscode zwei verschiedene Probleme?

Derselbe Statuscode schließt zwei verschiedene Türen. Die eine ist die Verkehrskontrolle: Das System sagt, Sie haben es in kurzer Zeit zu stark belastet. Die andere ist die Kontokontrolle: Das System sagt, Ihr nutzbares Kontingent ist aufgebraucht.

Diese Trennung ist wichtig, weil die Lösungen in entgegengesetzte Richtungen führen. Bei der Verkehrskontrolle werden Sie langsamer, und dieselbe Anfrage geht kurz danach durch. Bei der Kontokontrolle hilft dagegen kein Abbremsen, denn das Kontingent bleibt leer.

Zum Beispiel kann ein nächtlicher Stapeljob auf einmal an ein Rate Limit stoßen. Läuft derselbe Code morgens ohne Fehler, liegt daher die Ursache wohl im Verkehr. Taucht der Fehler dagegen morgens und abends auf, schauen Sie auf Guthaben und Ausgabenlimit.

Die offizielle Seite zu den Fehlercodes behandelt beide Gruppen unter getrennten Überschriften. Den Link finden Sie also am Ende dieses Artikels in den Quellen.

Wie unterscheiden Sie ein Rate Limit von insufficient_quota?

Am zuverlässigsten gelingt das also über den Antworttext. Das Fehlerobjekt enthält einen Typ und einen Code. Laut offizieller Seite kann der Typ bei Abrechnungsfehlern insufficient_quota lauten. Ist das Guthaben leer, sehen Sie außerdem speziellere Codes wie credit_balance_exhausted.

Meldungstexte können sich nämlich mit der Zeit ändern. Prüfen Sie beim OpenAI API Fehler 429 daher den Code, statt nach einem exakten Satz zu suchen. Sehen Sie auf dem Bildschirm eine ähnliche Warnung, verlassen Sie sich trotzdem auf den Code.

  • Rate Limit: Die Meldung sagt, Anfragen kamen zu schnell, und ein Retry-After Header kann folgen.
  • Plötzlicher Anstieg: Auch unter Ihrem Limit kann ein Code wie slow_down erscheinen, weil die Anfragerate zu schnell stieg.
  • Leeres Guthaben: Ihr vorausbezahltes Guthaben ist weg, und Warten hilft nicht.
  • Ausgabenlimit erreicht: Organisation oder Projekt erreichten eine monatliche Grenze, die Sie selbst gesetzt haben.
  • Nutzungslimit erreicht: Sie erreichten eine monatliche Grenze, die OpenAI vergeben hat, und müssen den Support kontaktieren.

Kurz gesagt, wenn der Code Quota oder Guthaben nennt, korrigieren Sie Ihre Abrechnung und nicht Ihren Code.

Was verraten Antworttext und Antwort Header?

Der Text nennt den Grund, die Header nennen dagegen das Timing. Laut OpenAI Dokumentation können Antworten Header enthalten, die Ihr verbleibendes Anfrage- und Tokenkontingent und die Zeit bis zum Zurücksetzen zeigen. Diese Header zu protokollieren ist der günstigste Weg, ein Problem später zu analysieren.

Der Header Retry-After nennt die Mindestwartezeit bei einem vorübergehenden Fehler. Allerdings heißt das nicht, dass sich ein Abrechnungs- oder Kontingentproblem von selbst löst. Die Dokumentation betont das daher ausdrücklich.

Halten Sie in der Praxis zwei Dinge fest: den Fehlercode und die Header mit dem Restkontingent. Fragt später jemand, warum ein 429 kam, lesen Sie dann die Aufzeichnung, statt zu raten.

Ergänzen Sie außerdem Modell, Projekt und Schlüssel in jeder Logzeile. Dieses Trio zeigt somit schnell, welche Anwendung das Limit verbraucht hat.

Welche Arten von Rate Limits gibt es?

Ein Rate Limit ist also nicht eine einzelne Zahl. Laut Dokumentation gibt es mehrere Maße, etwa Anfragen pro Minute und Token pro Minute. Manche Modelle haben zudem Tageslimits, und Bilder oder Audio können eigene Limits haben.

Es gilt dann, was Sie zuerst erreichen. Zum Beispiel stößt eine Anwendung mit vielen kurzen Anfragen ans Anfragelimit. Eine Anwendung mit wenigen riesigen Texten stößt dagegen ans Tokenlimit. Daher sollten Sie beide Maße getrennt beobachten.

Limits gelten auf Ebene der Organisation und des Projekts und unterscheiden sich je nach Modell. Einige Modelle teilen sich nämlich einen Pool. Somit kann starke Nutzung eines Modells auch den Anteil eines anderen beeinflussen.

Öffnen Sie im Dashboard die Limitzeilen Ihres Modells und notieren Sie, welches Maß bei Ihnen der Engpass ist. Protokollieren Sie dann jede Minute die genutzten Anfragen und Token. Dann sehen Sie das Limit kommen, bevor Sie dagegen laufen.

Möchten Sie die Einheit selbst auffrischen, lesen Sie unseren Leitfaden zu Token und API Kosten.

Wie funktionieren Exponential Backoff und Jitter?

Exponential Backoff heißt, dass Sie die Wartezeit nach jedem Fehlversuch verdoppeln. Jitter ist dagegen ein kleiner zufälliger Zuschlag auf diese Zeit, also ein Zufallsanteil. Das Ziel: Alle Clients sollen nicht in derselben Sekunde erneut versuchen.

Ein Vergleich hilft hier, denn er macht den Gedanken greifbar. Wollen hundert Menschen gleichzeitig durch eine Tür, verstopft sie. Wartet jeder etwas anders lang und geht einzeln hinein, entspannt sich der Fluss. Genau das leistet also die zufällige Wartezeit.

Das Konzept sieht so aus: Nach dem ersten Fehler warten Sie kurz, dann länger nach dem zweiten und noch länger nach dem dritten. Fügen Sie jeder Wartezeit einen zufälligen Anteil hinzu und begrenzen Sie stets Gesamtzeit und Versuchszahl.

Gibt es einen Header, folgen Sie zunächst dem Header. Laut Dokumentation ist Retry-After eine Untergrenze. Warten Sie also mindestens so lange und fügen Sie etwas Zufall hinzu. Fehlt der Header oder ist er ungültig, greifen Sie dann auf die Backoff Formel zurück.

Warum verschlimmert sofortiges Wiederholen die Lage?

Auch fehlgeschlagene Anfragen zählen zum Limit pro Minute. Die OpenAI Dokumentation sagt das klar, daher gilt es als gesichert. Senden Sie also nach einem 429 sofort dieselbe Anfrage erneut, füllen Sie das Limit schneller und sperren sich länger aus.

Zudem lauert eine weitere Falle: Es sind verschachtelte Wiederholungsschleifen. Das SDK versucht von selbst erneut, Ihr Code versucht erneut, und eine Job Warteschlange versucht ebenfalls erneut. Somit wird aus einer Nutzeraktion schnell ein Dutzend Anfragen.

  • Lassen Sie SDK Wiederholungen und eigenen Wiederholungscode also nicht gleichzeitig aktiv.
  • Begrenzen Sie außerdem Wiederholungen nach Anzahl und nach Gesamtzeit.
  • Wiederholen Sie keine Abrechnungs- oder Kontingentfehler, denn Warten behebt sie nicht.
  • Steigern Sie den Verkehr schrittweise statt in plötzlichen Sprüngen.

Schließlich ist ein verlässlicher Client einer, der sich selbst bremsen kann.

Wie helfen Warteschlangen und Stapelverarbeitung?

Eine Warteschlange lässt Sie Anfragen hinter einem Begrenzer aufreihen. Ihre Anwendung legt Anfragen daher in die Schlange, statt sie sofort zu senden. Ein Worker leitet sie dann mit kontrollierter Geschwindigkeit an die API weiter. So fangen Sie plötzliche Lastspitzen ab, ohne das Limit zu treffen.

Stapelverarbeitung (Batch) ist ein eigener Weg für nicht dringende Arbeit. Laut OpenAI Dokumentation kann die Batch API große Mengen an Anfragen verarbeiten, die keine sofortige Antwort brauchen, ohne Ihre synchronen Anfragelimits zu nutzen. Stapeljobs haben zudem ein eigenes Warteschlangenlimit.

Beispielszenario: Ein Onlineshop Team will über Nacht tausende Produktbeschreibungen zusammenfassen lassen. Der Job lässt keinen Nutzer warten, daher passt die Stapelverarbeitung. Live Chat Antworten bleiben dagegen sofort und nutzen den Großteil des Live Limits bequem.

Ist die Anfragezahl der Engpass, aber Token bleiben übrig, kann das Bündeln einiger kleiner Prompts in eine Anfrage den Durchsatz erhöhen. Tun Sie das allerdings nur, soweit die Antwortqualität stabil bleibt.

Verringern Cache und Prompt Caching den Fehler 429?

Ein Cache auf Ihrer Seite hilft also direkt. Liefert dieselbe Frage dieselbe Antwort, brauchen Sie die API kein zweites Mal aufzurufen. Häufige Fragen, feste Klassifizierungen und stabile Zusammenfassungen eignen sich gut für einen Cache.

Prompt Caching funktioniert dagegen anders. Es beschleunigt die Verarbeitung langer, wiederkehrender Prompt Anfänge und kann Kosten senken. Es löst ein Rate Limit aber nicht allein, denn die Zählung bleibt Sache des Anbieters. Prüfen Sie in der Dokumentation des Anbieters, wie zwischengespeicherte Token auf Ihre Limits zählen.

Den Mechanismus erklären wir in unserem Artikel zu Prompt Caching. Wir wiederholen den Aufbau hier nicht und behandeln nur den Zusammenhang mit dem 429.

Also entfernen Sie zuerst den unnötigen Aufruf und machen dann die übrigen Aufrufe günstiger. Diese Reihenfolge schützt somit Limit und Budget. Achten Sie beim Cache Schlüssel außerdem darauf, dass nutzerspezifische Daten nie bei einem anderen Nutzer landen.

Warum zählen max_tokens und kürzere Prompts?

Laut Dokumentation berücksichtigt die Schätzung des Rate Limits den Wert max_tokens. Lassen Sie ihn also höher als nötig, kann Kapazität zählen, die Sie nie nutzen. Somit nähern Sie sich dem Limit früher als nötig.

Die Lösung ist einfach: Setzen Sie dann eine Obergrenze nahe an der erwarteten Antwortlänge. Lassen Sie keinen sehr hohen Wert stehen, wo Sie eine kurze Antwort erwarten.

  • Zunächst entfernen Sie Wiederholungen aus Ihrem System Prompt.
  • Fassen Sie den Chatverlauf zusammen, statt ihn jede Runde komplett neu zu senden.
  • Danach teilen Sie sehr lange Dokumente und senden Sie nur die relevanten Teile.
  • Messen Sie vorher die Länge des Gesendeten. Unser Wörterzähler gibt eine grobe Orientierung.

Diese Schritte senken also zugleich Ihr 429 Risiko und Ihre Rechnung. Außerdem verkürzen sie die Antwortzeit.

Was ist eine Nutzungsstufe und wie beeinflusst sie Limits?

Eine Nutzungsstufe ist das Niveau, das Ihrer Organisation anhand der Zahlungshistorie zugewiesen wird. Laut OpenAI Dokumentation steigt Ihre Stufe automatisch, wenn Ihre gesamten Guthabenkäufe wachsen. Höhere Stufen bringen daher in der Regel höhere Rate Limits und höhere monatliche Nutzungsgrenzen.

Wir nennen hier keine Zahlen, weil sich Schwellen und Limits ändern können. Prüfen Sie aktuelle Werte auf der Limitseite im Dashboard und in der offiziellen Dokumentation. Eine Zahl aus einem alten Forenbeitrag führt also zu einer falschen Kapazitätsplanung.

Teams, die mit einem neuen Konto live gehen, wundern sich oft, denn die Limits sind anfangs niedrig. Eine Anwendung, die in der Entwicklung glatt lief, stößt mit echten Nutzern an die niedrige Stufe. Vergleichen Sie daher vor dem Start den erwarteten Verkehr mit Ihren Limits.

Außerdem kann der Anbieter für Unternehmensbedarf höhere Kapazitätsoptionen bieten. Allerdings ersetzen diese die oben genannten Schritte zur Wiederherstellung nicht.

Wie verfolgen Sie die Nutzung nach Projekt und Schlüssel?

Limits gelten auf Ebene der Organisation und des Projekts. Daher verfolgen Sie die Nutzung daher auf derselben Ebene. Ein eigenes Projekt und ein eigener Schlüssel pro Anwendung zeigen, welche Anwendung den Anteil verbraucht hat.

Beispielszenario: Ein Chatbot, ein Reporting Tool und eine Content Automatisierung laufen in derselben Organisation. Liegen alle in einem Projekt, kann der nächtliche Berichtsjob tagsüber den Anteil des Chatbots aufessen. In getrennten Projekten ist die Quelle dagegen sofort sichtbar.

  • Geben Sie jeder Anwendung ein eigenes Projekt und einen eigenen Schlüssel.
  • Setzen Sie außerdem für Projekte ein monatliches Ausgabenlimit und eine Warnschwelle. Die Dokumentation trennt Warnungen von harten Obergrenzen.
  • Protokollieren Sie zudem Modell, Projekt und Anfragezahl in Ihrer eigenen Anwendung.
  • Prüfen Sie die Nutzungsansicht im Dashboard in regelmäßigen Abständen.

Menünamen können sich ändern, daher verlassen wir uns nicht auf exakte Schaltflächentexte. Suchen Sie im Dashboard nach den Bereichen für Nutzung und Limits.

Warum ist ein gemeinsamer Schlüssel für mehrere Anwendungen riskant?

Ein gemeinsamer Schlüssel erzeugt also zwei Probleme. Das eine ist verlorene Sichtbarkeit: Sie erkennen nicht, welche Anwendung wie viele Anfragen gesendet hat. Das andere ist die Sicherheit: Je mehr Orte einen Schlüssel enthalten, desto höher ist das Leckrisiko.

Zudem sagt die Dokumentation, dass Limits auch auf Organisationsebene gelten und die Nutzung von Kollegen den Anteil verbrauchen kann. Sie können also Ihren Code reparieren, während jemand anderes das Limit mit einem Testskript füllt. Prüfen Sie das daher bei der Diagnose immer.

Zunächst betten Sie Schlüssel nicht in den Quellcode ein. Speichern Sie sie stattdessen serverseitig als Umgebungsvariable oder in einem Secret Manager. Legen Sie sie dann niemals in einen Browser oder in ein mobiles App Paket. Vermuten Sie ein Leck, erstellen Sie sofort einen neuen Schlüssel und widerrufen Sie den alten.

Die Grundlagen der API finden Sie in unserer Anleitung zur Nutzung der OpenAI API.

Wie diagnostizieren Sie einen 429 Schritt für Schritt?

Der Ablauf bei einem OpenAI API Fehler 429, den wir in der Praxis nutzen, ist kurz, und jeder Schritt schließt den nächsten aus. Lesen Sie zuerst den Code, bestimmen Sie dann den Umfang und prüfen Sie danach das Timing. So stützen Sie sich auf Belege statt auf Vermutungen.

  1. Lesen Sie den Code: Rate Limit, Guthaben oder Ausgabenlimit?
  2. Bestimmen Sie den Umfang: Zeigt sich der Fehler bei einem Modell, einem Projekt oder in der ganzen Organisation?
  3. Prüfen Sie das Timing: Tritt er zu Stoßzeiten oder bei einem bestimmten Stapeljob auf?
  4. Fragen Sie nach der letzten Änderung: Eine neue Funktion, eine neue Schleife oder ein neuer Kollege kann den Verkehr erhöht haben.
  5. Senden Sie zuletzt von Hand eine kleine Anfrage. Klappt sie, liegt das Problem also an der Last. Scheitert sie, liegt es am Konto.

Beispielszenario: Ein Team sieht am Dienstagmorgen 429 Fehler. Der Code zeigt also ein Rate Limit, der Umfang ist ein Modell, und das Timing passt zu einem Berichtsjob um neun Uhr. Die Lösung ist daher: den Bericht in die Nacht verlegen und an eine Warteschlange anbinden.

Dieses Beispiel ist erfunden und beschreibt keinen echten Kunden. Die Logik gilt dennoch: Umfang und Timing nennen oft schon die Ursache.

Wie zeigen Sie den Fehler den Nutzern?

Für Endnutzer ist ein 429 kein technischer Begriff. Zeigen Sie eine schlichte Meldung wie "Das System ist ausgelastet, bitte versuchen Sie es in wenigen Sekunden erneut". Geben Sie den rohen Fehlertext oder Schlüsselinformationen nicht auf dem Bildschirm aus.

Im Hintergrund darf die Arbeit außerdem nicht verloren gehen. Die Anfrage sollte zurück in die Schlange, nach der Backoff Regel erneut laufen und das Ergebnis liefern, sobald es bereit ist. In Chatoberflächen ist eine Schreibanzeige ein natürlicher Weg, diese Wartezeit zu überbrücken.

  • Zeigen Sie stattdessen eine kurze, ruhige Wartemeldung.
  • Zeigen Sie dem Nutzer also nie den rohen Fehlertext.
  • Sendet ein Nutzer Anfragen hintereinander, deaktivieren Sie kurz die Senden Schaltfläche.
  • Bei Guthabenfehlern benachrichtigen Sie einen Administrator und nicht den Nutzer.

Sorgen Sie außerdem dafür, dass das Team bei knapp werdendem Guthaben automatisch eine Warnung erhält. Bemerken Kunden es vor Ihnen, verlieren Sie dann Vertrauen.

Wie testen Sie das 429 Verhalten in der Entwicklung?

Wiederholungscode erstmals in der Produktion zu testen ist keine gute Idee. Setzen Sie stattdessen eine Attrappe zwischen Client und API. Diese Schicht liefert in festen Abständen Antworten im Stil eines 429 und lässt Sie messen, wie Ihr Code reagiert.

Prüfen Sie beim Testen daher drei Dinge. Erstens: Beachtet Ihr Code die Wartezeit aus dem Header? Zweitens: Bleibt die Versuchszahl an der Obergrenze stehen? Drittens: Hört er bei einem Guthabenfehler auf zu wiederholen und löst eine Warnung aus?

Treiben Sie die echte API deshalb nicht absichtlich ans Limit. Das kostet nämlich Geld und belastet Ihr Konto ohne Grund. Die Attrappe liefert stattdessen dieselbe Information ohne Risiko.

Dasselbe Prinzip gilt für Lasttests. Steigern Sie den Verkehr schrittweise, stoppen Sie, sobald Sie das Limit sehen, und halten Sie die Ergebnisse fest. Notieren Sie danach nach jedem Test, welche Last welchen Fehler erzeugte. Daraus ergibt sich ein sicherer Betriebsbereich für den Produktionsverkehr.

Wie teilen Sie Kapazität in einer Mehrnutzer Anwendung fair auf?

Ein einzelner Nutzer oder Kunde kann den gesamten Anteil verbrauchen. Dann sehen andere Nutzer einen 429, obwohl sie nichts dafürkönnen. Daher ist ein internes Limit pro Nutzer in Ihrer eigenen Anwendung sinnvoll.

Das interne Limit greift daher vor dem OpenAI Limit. Ein Vielnutzer wird dann gebremst, alle anderen bleiben unberührt. Das ist eine faire Verteilung und sie arbeitet mit Ihrer Warteschlange zusammen.

  • Legen Sie ein internes Anfragelimit pro Minute je Nutzer oder Kunde fest.
  • Verlagern Sie zudem lange Jobs in eine Hintergrundschlange, die vom Nutzer unabhängig ist.
  • Trennen Sie außerdem Vorrangiges, etwa den Live Chat, von Stapelarbeit.
  • Nutzen Sie dann für Testnutzer ein strengeres internes Limit.

Zum Beispiel kann Ihr Firmenkunde über Nacht eine Sammelzusammenfassung anfordern, während der Live Support Chat weiterläuft. Dank der Prioritätstrennung wartet der Chat also nie.

Interne Limits erleichtern zudem die Kostenkontrolle. Eine fehlerhafte Schleife mit hunderten Anfragen stoppt somit, bevor sie Ihr ganzes Budget verbraucht.

Warum treffen Automatisierungstools so oft auf den Fehler 429?

Workflow Tools verarbeiten Datensätze nämlich oft parallel. Eine Tabelle mit hundert Zeilen kann zu hundert gleichzeitigen API Aufrufen werden. Das Ergebnis ist daher binnen Sekunden ein Rate Limit.

Die Lösung: Senken Sie die Parallelität im Ablauf und fügen Sie zwischen den Zeilen eine kleine Pause ein. Die meisten Tools bieten dafür also eine Einstellung zu Iteration oder Parallelität. Der Name der Einstellung wechselt je nach Tool, deshalb lesen Sie die Dokumentation Ihres Tools.

  • Verringern Sie die Zahl der parallel laufenden Schritte.
  • Fügen Sie dann nach jeder Zeile eine kurze Pause ein.
  • Wiederholen Sie bei einem Fehler nur diese Zeile, statt den ganzen Ablauf zu stoppen.
  • Teilen Sie außerdem große Tabellen in nächtliche Stapeljobs auf.

Wollen Sie solche Abläufe auf solidem Grund bauen, planen Sie die Architektur von Anfang an. Nachträgliche Flicken erzeugen nämlich häufig neue Fehler.

Wie lassen sich die Arten des OpenAI API Fehler 429 in einer Tabelle vergleichen?

Die folgende Tabelle stellt die Fälle des OpenAI API Fehler 429 nebeneinander, die wir am häufigsten sehen. Die Codenamen folgen dabei den Überschriften der offiziellen Fehlerseite. Der Meldungstext kann sich ändern, deshalb zählt der Code.

FehlerartAnzeichenLösung
Rate Limit für Anfragen oder TokenViele Anfragen in kurzer Zeit, nach Warten geht es durchBremsen, die Retry-After Zeit warten, Jitter ergänzen
Plötzlicher Anstieg (slow_down)Sie liegen unter dem Limit, aber die Rate stieg schnellRate senken und schrittweise erhöhen
Guthaben leer (credit_balance_exhausted)Warten hilft nichtGuthaben in der Abrechnung aufladen
Ausgabenlimit der OrganisationAlle Projekte stoppen zugleichLimit erhöhen oder entfernen oder den Periodenwechsel abwarten
Ausgabenlimit des ProjektsNur dieses Projekt stopptLimit in den Projekteinstellungen anpassen
NutzungslimitSie erreichten eine von OpenAI vergebene MonatsgrenzeSupport für ein höheres Limit kontaktieren

Die ersten zwei Zeilen lösen sich durch Warten. Die unteren vier Zeilen verlangen dagegen eine Aktion in der Abrechnung. Wer diese Trennung im Kopf hat, halbiert also die Diagnosezeit.

Wie sollte eine Checkliste für dauerhafte Vorsorge aussehen?

Den OpenAI API Fehler 429 einmal zu lösen reicht daher nicht. Damit Sie denselben Fehler nicht in einem Monat wieder erleben, nehmen Sie die folgende Liste in Ihre Anwendung auf. Jeder Punkt ist eine kleine Aufgabe, doch zusammen machen sie einen großen Unterschied.

  1. Werten Sie den Fehlercode aus: Beim Rate Limit wiederholen, beim Guthaben nicht wiederholen und das Team informieren.
  2. Ergänzen Sie zudem den Backoff um zufällige Wartezeit und begrenzen Sie die Versuche.
  3. Nutzen Sie dann einen zentralen Begrenzer und eine Warteschlange.
  4. Verlagern Sie außerdem nicht dringende Arbeit in die Stapelverarbeitung.
  5. Geben Sie jeder Anwendung ein eigenes Projekt und einen eigenen Schlüssel.
  6. Richten Sie Ausgabenwarnungen ein, damit Sie vom Guthaben erfahren, bevor es leer ist.
  7. Protokollieren Sie Antwort Header und Fehlercodes.
  8. Führen Sie vor dem Start einen Lasttest durch und vergleichen Sie den erwarteten Verkehr mit Ihren Limits.

Selbst für ein technisches Team ist das etwa ein halber Tag Arbeit. Dafür sinkt dann die Zahl der nächtlichen Alarme spürbar.

Welche Abkürzungen sollten Sie meiden?

Bei einem 429 wirken manche Abkürzungen nämlich verlockend. Allerdings gefährden jene, die gegen die Nutzungsbedingungen verstoßen, Ihr Konto. Mehrere Konten zu eröffnen, um dieselbe Nutzung aufzuteilen, Konten zu wechseln, um Limits zu umgehen, oder den Schlüssel einer anderen Person zu verwenden, gehört dazu.

Das gilt als Umgehung des Systems, und wir empfehlen es nicht. Reicht Ihr Limit nicht, ist der richtige Weg: die Nutzungsstufe erhöhen, über den offiziellen Kanal ein höheres Limit beantragen und die Prompts effizient gestalten.

Eine weitere schlechte Idee ist, den Fehler still zu schlucken und dem Nutzer eine leere Antwort zu zeigen. Zeigen Sie stattdessen eine kurze Wartemeldung und halten Sie den Job in der Schlange. Somit behalten Sie das Vertrauen.

  • Guthaben mit gefälschten oder gestohlenen Zahlungsdaten aufzuladen ist verboten.
  • Kaufen Sie bei Dritten keine Dienste zum "Limit freischalten".
  • Fügen Sie Ihren Schlüssel nicht auf unbekannten Teilen Seiten ein.

Wie kann unser Team bei diesem Problem helfen?

Als Talha Aslan und Team entwerfen wir bei KI Integrationen die Schichten für Warteschlange, Wiederholung und Überwachung. Möchten Sie, dass wir das 429 Verhalten einer bestehenden Anwendung prüfen oder eine belastbare Architektur neu aufbauen, können Sie für unsere KI Automatisierung ein Angebot anfordern.

Hinweis: Dieser Artikel ist allgemeine Information. Limits, Preise und Modelldetails ändern sich oft, prüfen Sie aktuelle Werte in der offiziellen OpenAI Dokumentation. Wir geben hier also keine Garantie.

Offizielle Quellen: OpenAI Leitfaden zu Rate Limits und OpenAI Seite zu Fehlercodes. Zu weiteren Problemen lesen Sie unsere Beiträge zur ChatGPT Nachrichtenlimit Meldung und zu ChatGPT Datei Upload Problemen.

Häufig gestellte Fragen

Was sollte ich bei einem 429 zuerst prüfen?
Prüfen Sie zuerst die Felder für Code und Typ im Antworttext. Sie trennen ein Rate Limit von einem Guthaben- oder Kontingentproblem. Danach sehen Sie sich die Antwort Header an, denn der Wert Retry After nennt die kürzeste Wartezeit. Verweist der Code auf die Abrechnung, korrigieren Sie Zahlung und Limits, statt zu warten. Prüfen Sie schließlich andere Anwendungen derselben Organisation.
Verschwindet insufficient_quota, wenn ich warte?
Nein, in den meisten Fällen nicht. Dieser Code stammt aus Abrechnung oder Quota und zeigt, dass Guthaben, Ausgabenlimit oder Nutzungskontingent aufgebraucht sind. Sie müssen Guthaben aufladen oder das Limit anpassen. Die Dokumentation betont außerdem, dass der Header Retry After solche Probleme nicht löst, also wiederholen Sie sie nicht.
Wie lange sollte ich beim Exponential Backoff warten?
Beginnen Sie mit einer kurzen Wartezeit, verdoppeln Sie sie bei jedem Versuch und fügen Sie einen kleinen Zufallsanteil hinzu. Begrenzen Sie stets Gesamtzeit und Versuchszahl. Enthält die Antwort einen Retry After Wert, warten Sie mindestens so lange. Denken Sie daran, dass auch gescheiterte Versuche zum Minutenlimit zählen. Aktuelle Empfehlungen stehen im OpenAI Leitfaden zu Rate Limits.
Kann ein gemeinsamer Schlüssel mehrerer Anwendungen einen 429 auslösen?
Ja, das kann passieren. Limits gelten auf Ebene von Organisation und Projekt, daher kann starke Nutzung einer Anwendung den Anteil der anderen verbrauchen. Ein eigenes Projekt und ein eigener Schlüssel je Anwendung erleichtern die Diagnose und begrenzen den Schaden bei einem Leck. Außerdem fressen Testskripte von Kollegen dann nicht Ihren Produktionsanteil.
Löst die Batch API die 429 Probleme?
Sie hilft stark bei Arbeit, die keine sofortige Antwort braucht. Laut Dokumentation laufen Stapeljobs, ohne Ihre synchronen Anfragelimits zu nutzen, und haben ein eigenes Warteschlangenlimit. Für Live Antworten an Nutzer brauchen Sie weiterhin einen Begrenzer und Backoff. Prüfen Sie aktuelle Bedingungen in der offiziellen Dokumentation und rechnen Sie mit späteren Ergebnissen.
Darf ich mehrere Konten eröffnen, um das Limit zu umgehen?
Wir raten davon ab. Mehrere Konten zur Umgehung eines Limits können gegen die Nutzungsbedingungen verstoßen und Ihre Konten gefährden. Der richtige Weg ist, die Nutzungsstufe zu erhöhen, über den offiziellen Kanal ein höheres Limit zu beantragen, Prompts zu kürzen und Jobs in eine Warteschlange zu legen. Diese Methoden halten dauerhaft und sind sicher.
  • openai api 429
  • rate limit
  • insufficient_quota
  • api fehler lösen
  • exponential backoff
  • ki api
  • openai quota
Teilen:
Talha Aslan

Google Partner und Experte für digitales Marketing. Seit 2012 praktisch in SEO, Google Ads, Webdesign und E-Commerce Projekten; jeder Beitrag hier stammt aus dieser Erfahrung.

Nächstes Projekt

Angebot für Ihr Projekt.

Ihre Anfrage geht direkt an Talha Aslan und Team: Strategie von Talha, Umsetzung durch ein erfahrenes Team. Wir melden uns am selben Tag und senden Umfang, Zeitplan und Preis innerhalb von 1 Werktag als schriftliches Angebot.