Claude API 529 overloaded_error — was es bedeutet und wie man es übersteht

529 ist der eine Claude-Fehler, den dein Code nicht verursacht hat: Anthropic selbst ist überlastet. Du kannst ihn nicht beheben, sondern nur kontrolliert abfangen. Das bedeutet geduldige Retries, ein Fallback-Modell und niemals eine Verschärfung des Ausfalls durch sofortige Retry-Stürme.

Der Fehler

response (HTTP 529)

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

Ursachen und Lösungen im Überblick

Ursache	Lösung
Überlastung auf Anbieterseite (Tage mit neuen Modellveröffentlichungen, regionale Ausfälle)	Backoff mit Jitter; die Statusseite des Anbieters prüfen, statt die App neu zu deployen.
Dein Burst-Traffic traf während eines bereits angespannten Ausfalls ein	Batchaufgaben verteilen; eine Verzögerung von 10 Minuten behebt das meistens.

Retries wie ein guter Bürger ausführen

Behandle 529 wie 429 ohne Retry-After: exponentieller Backoff ab etwa 2 Sekunden, Jitter, Begrenzung auf 30–60 Sekunden, nach ungefähr 5 Versuchen aufgeben und die Aufgabe in eine Warteschlange stellen. Der Backoff-Ausschnitt aus unserem 429-Leitfaden behandelt 529 im selben Zweig.

Ausweichen statt auszufallen

Definieren Sie für latenzkritische Pfade einen Fallback: Dieselbe Familie (Sonnet → Haiku) hält das Verhalten ähnlich; ein anbieterübergreifender Fallback (Claude → GPT) übersteht einen vollständigen Ausfall des Anbieters. Bei einem OpenAI-kompatiblen Endpunkt ist das eine Änderung in einer einzigen Zeichenkette:

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          # saturated — try the next tier
    raise last

Wenn Sie Kunavo verwenden

Kunavo leitet Claude über mehrere Upstream-Pfade und sein Multi-Modell-Katalog macht den anbieterübergreifenden Failover zu einer Änderung der Modellzeichenkette bei demselben Schlüssel und Wallet — das oben beschriebene Failover-Muster benötigt kein zweites Konto. 529-Fehler, die Sie erreichen, werden weiterhin niemals berechnet. Kapazität und Preis sind getrennte Fragen; für Letzteres finden Sie die Preise pro Modell in der Preisliste der Anthropic-Claude-API.

Häufig gestellte Fragen

Ist ein 529-Fehler meine Schuld?

Nein. Es handelt sich um kapazitätsbedingte Probleme auf Anbieterseite. Ihre einzigen Pflichten bestehen darin, die Situation nicht zu verschärfen (Backoff, Jitter) und eine Failover-Möglichkeit zu haben, falls der Vorfall länger als Ihr Latenzbudget dauert.

529 vs. 429 — was ist der Unterschied?

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