Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

HTTP 429 bedeutet, dass ein Dienst zu viele Anfragen in einem bestimmten Zeitraum erkannt hat. Bei einer API prüfen Sie zuerst den Antworttext und den Retry-After-Header. Warten Sie die angegebene Zeit ab und senken Sie bei einem vorübergehenden Limit die Anfragefrequenz. Bei einer Website vermeiden Sie weiteres schnelles Neuladen und warten die angezeigte Zeit ab. Ist ein Guthaben oder Nutzungslimit erschöpft, hilft erneutes Senden nicht.

Was bedeutet Fehler 429?

Der HTTP-Statuscode 429 bedeutet, dass ein Nutzer innerhalb eines bestimmten Zeitraums zu viele Anfragen gesendet hat. So definiert es RFC 6585, Abschnitt 4. Eine Antwort sollte Details zur ausgelösten Bedingung enthalten und kann mit dem Header Retry-After angeben, wie lange Sie vor einem neuen Versuch warten sollen.

Der Statuscode verrät für sich allein jedoch nicht, welches Limit erreicht wurde. Der Server legt selbst fest, wie er Nutzer identifiziert und Anfragen zählt. Das Limit kann etwa an Zugangsdaten, Cookies, eine bestimmte Ressource oder eine größere Servergruppe gebunden sein. Deshalb ist ein 429 nicht automatisch ein Problem mit Ihrem Browser oder Ihrer Internetverbindung.

Erst unterscheiden: Website oder API?

Wenn der Fehler auf einer Website erscheint

Warten Sie die auf der Seite genannte Zeit ab und stoppen Sie automatische Aktualisierungen. Vermeiden Sie schnelle, wiederholte Ladeversuche, denn die Website oder ein zwischengeschalteter Dienst kann Anfragen nach eigenen Regeln zählen. Bleibt der Fehler nach angemessener Wartezeit bestehen, notieren Sie die URL, den Zeitpunkt und den angezeigten Wortlaut und wenden Sie sich an den Websitebetreiber.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Sale
Pearson Computer Networking, 8E
  • brand: Pearson
  • Computer Networking, 8e

Cookies zu löschen, den Browser zu wechseln oder ein VPN zu verwenden ist keine verlässlich belegte Universalmaßnahme: Welche Merkmale der Dienst für seine Begrenzung heranzieht, bestimmt der Betreiber.

Wenn ein Skript oder eine API betroffen ist

Prüfen Sie die vollständige Antwort und strukturierte Fehlerfelder, bevor Sie die Anfrage erneut senden. Ein API-429 kann ein vorübergehendes Ratenlimit anzeigen, aber auch auf erschöpfte vorausbezahlte Credits, ein Organisations- oder Projektlimit oder ein Ausgabenlimit zurückgehen. Nur bei einer vorübergehenden Ratenbegrenzung helfen Warten und Drosseln. Bei einem Abrechnungs- oder Kontingentfehler muss die zuständige Person das angezeigte Limit prüfen. Die OpenAI-Anleitung zu Rate-Limits und 429-Fehlern beschreibt diese Ursachen für OpenAI-APIs; sie sind nicht automatisch auf jeden Anbieter übertragbar.

API-Fehler 429 Schritt für Schritt beheben

  1. Fehlerdetails sichern. Notieren Sie den HTTP-Status, die vollständige Fehlermeldung, den Fehlercode, den Zeitpunkt samt Zeitzone, die Request-ID und den betroffenen Dienst. Geben Sie dabei niemals API-Schlüssel oder andere Geheimnisse weiter.
  2. Das ausgelöste Limit ermitteln. Prüfen Sie, ob die Meldung Anfragen, Tokens, ein Konto, eine Organisation oder ein Projekt betrifft. Anbieter können unterschiedliche Limits für Anfragen und Tokens sowie zusätzliche Grenzen auf Organisations- und Projektebene festlegen. Kurzfristige Limits können außerdem strenger sein als ein Minutenmittelwert: Ein kurzer Anfrageanstieg kann einen Fehler auslösen, obwohl die durchschnittliche Rate unauffällig aussieht. Die OpenAI-Anleitung veranschaulicht das mit 60 Anfragen pro Minute, die zusätzlich in kürzeren Zeitfenstern wie einer Sekunde begrenzt werden können. Das ist ein Anbieterbeispiel, kein allgemeines HTTP-Limit.
  3. Retry-After beachten. Wenn der Server einen gültigen Wert sendet, warten Sie mindestens die angegebene Zeit, bevor Sie es erneut versuchen. RFC 6585 erlaubt diesen Header; die OpenAI-Hilfe empfiehlt, einen gültigen Wartewert mindestens einzuhalten.
  4. Anfragen glätten. Verteilen Sie Aufrufe gleichmäßiger über die Zeit und senken Sie die Zahl gleichzeitiger Anfragen. Wenn kein gültiger Retry-After-Wert vorliegt, nutzen Sie begrenztes exponentielles Backoff mit Zufallsanteil (Jitter), statt sofort erneut zu senden. Google dokumentiert für seine API ein Beispiel mit einer anfänglichen Wartezeit von 1 Sekunde, einer Obergrenze von 32 Sekunden und bis zu 1 Sekunde Jitter. Diese Werte sind keine universelle Vorgabe für andere Dienste. Siehe die Google-Anleitung zu Fehlerbehandlung, Ratenlimits und Kontingenten.
  5. Wiederholungen begrenzen. Legen Sie eine Höchstzahl von Versuchen und eine maximale Gesamtdauer fest. Fehlgeschlagene Anfragen können weiterhin zum Minutenlimit beitragen; sofortige oder endlose Wiederholungen können die Situation verschlimmern. Prüfen Sie außerdem, ob Ihr SDK bereits automatisch Wiederholungen ausführt, bevor Sie eine zusätzliche Retry-Schleife einbauen. Die jeweilige Konfiguration hängt vom SDK ab. Für Gemini beschreibt Google ebenfalls Wiederholungsstrategien bei vorübergehenden Fehlern in seinem Gemini-API-Leitfaden zur Fehlerbehebung.
  6. Abrechnung oder Kontingent prüfen. Nennt die Antwort erschöpfte Credits oder ein Nutzungs- beziehungsweise Ausgabenlimit, senden Sie nicht einfach weiter. Prüfen Sie den genannten Kontostand oder Grenzwert. Eine berechtigte Person muss gegebenenfalls das Limit ändern; Änderungen an Ausgabenlimits können verzögert wirksam werden.
  7. Bei anhaltendem Fehler eskalieren. Wenden Sie sich mit den gesicherten Fehlerdetails an den offiziellen Support des API-Anbieters. Teilen Sie keine Schlüssel oder Zugangsdaten mit.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Warum tritt ein 429 trotz niedriger Durchschnittsrate auf?

Ein Dienst kann Anfragen in kurzen Zeitfenstern zählen, statt nur einen Durchschnitt über eine Minute zu betrachten. Deshalb kann ein kurzer Spitzenwert ein Limit überschreiten, obwohl Ihre langfristige Rate niedrig wirkt. Bei APIs kommen weitere getrennte Begrenzungen hinzu, etwa für Anfragen und Tokens oder für Organisation und Projekt. Welche davon gilt, lässt sich nur anhand der Anbieterantwort und der Kontoeinstellungen bestimmen.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.