Claude-Fehler 529 overloaded_error — Ursache und Wiederholungsstrategie

529 ist der einzige Claude-Fehler, den Ihr Code nicht verursacht hat: Überlastet ist Anthropic. Sie können ihn nicht beheben — nur elegant abfangen. Das bedeutet geduldige Wiederholungen mit Backoff, ein Ausweichmodell für latenzempfindliche Pfade und vor allem keine unmittelbaren Wiederholungsstürme, die den Vorfall verstärken.

Der Fehler

respuesta (HTTP 529)

{
  "type": "error",
  "error": { "type": "overloaded_error",
             "message": "Overloaded" }
}

Ursachen und Lösungen im Überblick

Ursache	Lösung
Überlastung auf Anbieterseite (Launch-Tage, regionale Vorfälle). Betrifft alle Kunden gleichzeitig.	Backoff mit Jitter; prüfen Sie die Anthropic-Statusseite, statt Ihre Anwendung erneut bereitzustellen.
Ihre eigene Lastspitze trifft auf bereits angespannte Kapazität.	Verteilen Sie Aufträge in Batches; zehn Minuten Verzögerung reichen oft aus, damit sich die Lage beruhigt.
Verwechslung mit 429: In den Logs sieht ein Ratenlimit ähnlich aus, die Ursache ist jedoch völlig anders.	429 bedeutet, dass Sie Ihre Limits überschritten haben (der Server ist in Ordnung); 529 bedeutet, dass der Server überlastet ist (Ihr Kontingent ist in Ordnung). Nur 429 enthält den Hinweis Retry-After.
Es ist kein Ausweichpfad definiert, daher erreicht ein Anbieterproblem den Endnutzer.	Definieren Sie eine Ausweichkette — innerhalb derselben Familie (Sonnet → Haiku) bleibt das Verhalten ähnlich; zwischen Anbietern (Claude → GPT) überstehen Sie einen vollständigen Vorfall.

Wiederholen, ohne den Vorfall zu verstärken

Behandeln Sie 529 wie 429 ohne Retry-After: exponentieller Backoff ab etwa 2 Sekunden, mit Jitter, begrenzt auf 30–60 Sekunden, nach etwa fünf Versuchen aufgeben und die Arbeit in eine Warteschlange stellen. Der Jitter ist entscheidend: Ohne ihn kehren alle Clients gleichzeitig zurück und verlängern genau die Überlastung, der sie entkommen wollen.

Umschalten statt ausfallen

Definieren Sie für latenzempfindliche Pfade eine Ausweichkette. Bei einem OpenAI-kompatiblen Endpunkt ist das eine einzige geänderte Zeichenkette — ohne zweites SDK und ohne zweites Konto:

failover.py

PREFERRED = ["claude-sonnet-5", "claude-haiku-4-5", "gpt-5-6-terra"]

def complete(messages):
    last = None
    for model in PREFERRED:
        try:
            return client.chat.completions.create(
                model=model, messages=messages, max_tokens=800)
        except APIStatusError as e:
            if e.status_code not in (429, 500, 529):
                raise
            last = e          # saturado — probar el siguiente nivel
    raise last

Erst dann den eigenen Code prüfen

Wenn 529 nur bei einer Anfrageart auftreten, während alle anderen Aufrufe gleichzeitig funktionieren, handelt es sich nicht um einen allgemeinen Vorfall: Prüfen Sie, ob dieser Pfad ungewöhnlich große Prompts sendet oder in einer Endlosschleife auslöst. Betrifft es dagegen alle Aufrufe plötzlich und verschwindet von selbst, war die Ursache Kapazität — dann gehören Wiederholungen und Ausweichpfad zur Lösung, keine Refaktorierung.

Wenn Sie Kunavo verwenden

Kunavo routet Claude über mehrere Ursprungswege, und sein multimodaler Katalog macht den Anbieterwechsel zu einer Änderung des Modellnamens bei demselben Schlüssel und demselben Guthaben — das obige Muster benötigt kein zweites Konto. 529-Fehler, die Sie trotzdem erreichen, werden nie berechnet. Kapazität und Preis sind unterschiedliche Fragen; die Tarife pro Modell finden Sie für die zweite unter den Claude-Preisen.

Häufig gestellte Fragen

Ist ein 529 meine Schuld?

Nein. Es handelt sich um Kapazität auf Anbieterseite. Ihre einzigen Pflichten sind, den Vorfall nicht zu verstärken (Backoff, Jitter) und einen Ausweichpfad zu haben, falls der Vorfall länger dauert als Ihr Latenzbudget.

529 gegenüber 429: Was ist der Unterschied?

429 bedeutet, dass Sie Ihre Limits überschritten haben; der Server ist in Ordnung. 529 bedeutet, dass der Server selbst überlastet ist; Ihr Kontingent ist in Ordnung. Beide Fehler können wiederholt werden; nur 429 enthält Retry-After.

Wie lange dauert ein 529-Vorfall normalerweise?

Das ist nicht vorhersehbar und kann nicht garantiert werden — deshalb sind Backoff mit Obergrenze und eine Warteschlange die richtige Antwort, nicht eine fest im Code verankerte Wartezeit. Wenn Ihr Pfad ein Latenzbudget hat, übernimmt der Ausweichpfad anstelle des Wartens.

Werden Aufrufe berechnet, die mit 529 enden?

Über Kunavo nein: Eine Anfrage, die mit einem Fehler endet, wird nicht berechnet. Bei einem Direktvertrag hängt dies von den Abrechnungsregeln des jeweiligen Anbieters ab.

Claude-API-Fehler 529 overloaded_error — was er bedeutet und wie man ihn abfängt