Fehler 529 overloaded_error in der Claude-API — Bedeutung und Gegenmaßnahmen

529 ist der einzige Claude-Fehler, den Ihr Code nicht verursacht hat: Anthropic selbst ist überlastet. Sie können das Problem nicht beheben, aber gut abfedern. Das bedeutet geduldige Retries, ein Ausweichmodell und niemals sofortige Wiederholungen, die den Vorfall verstärken.

Der Fehler

resposta (HTTP 529)

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

Ursachen und Lösungen im Überblick

Ursache	Lösung
Überlastung des Anbieters (Veröffentlichungstage, regionale Vorfälle)	Exponentielles Backoff mit Jitter. Prüfen Sie die Statusseite des Anbieters, statt das Deployment erneut auszuführen.
Ihr Verkehrshoch ist während eines Teilausfalls gesunken	Verteilen Sie Batch-Jobs; zehn Minuten Wartezeit lösen das Problem oft.
Sofortige Wiederholung in einer Schleife	Sofort erneut zu versuchen, vervielfacht die Last und verlängert den Vorfall für alle, auch für Sie.

Führen Sie Retries verantwortungsvoll durch

Behandeln Sie 529 wie 429 ohne retry-after-Header: exponentielles Backoff ab etwa 2 s, mit Jitter, einer Obergrenze von 30–60 s, nach etwa 5 Versuchen abbrechen und die Aufgabe in eine Warteschlange stellen. Derselbe Codezweig, der 429 behandelt, funktioniert auch für 529.

retry.py

import time, random
from openai import APIStatusError

def com_retry(fn, tentativas=5):
    for i in range(tentativas):
        try:
            return fn()
        except APIStatusError as e:
            if e.status_code not in (429, 500, 529):
                raise
            espera = min(2 ** i + random.random(), 60)
            time.sleep(espera)
    raise RuntimeError("esgotou as tentativas")

Wechseln Sie das Modell, statt abzustürzen

Legen Sie für latenzkritische Pfade ein Ausweichmodell fest: Innerhalb derselben Familie (Sonnet → Haiku) bleibt das Verhalten ähnlich; zwischen Anbietern (Claude → GPT) überstehen Sie einen vollständigen Vorfall. An einem OpenAI-kompatiblen Endpunkt ändern Sie dafür nur eine Zeichenkette.

failover.py

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

def completar(mensagens):
    ultimo = None
    for modelo in PREFERIDOS:
        try:
            return client.chat.completions.create(
                model=modelo, messages=mensagens, max_tokens=800)
        except APIStatusError as e:
            if e.status_code not in (429, 500, 529):
                raise
            ultimo = e          # saturado — tenta o próximo
    raise ultimo

Verwechseln Sie 529 nicht mit 429 oder 402

429 bedeutet, dass Sie Ihre Limits überschritten haben (der Server funktioniert). 529 bedeutet, dass der Server überlastet ist (Ihr Kontingent ist in Ordnung). 402 bedeutet unzureichendes Guthaben. Im Log sehen die drei Fehler ähnlich aus, erfordern aber völlig unterschiedliche Maßnahmen: Nur 429 und 529 sollten wiederholt werden.

Wenn Sie Kunavo verwenden

Bei Kunavo liegt derselbe Multimodellkatalog hinter einem einzigen Schlüssel und einem einzigen Guthaben. Der Anbieter-Failover aus dem Beispiel oben besteht daher nur im Wechsel des Modellnamens — kein zweites Konto und keine zweite Registrierung sind erforderlich. Fehlgeschlagene Anfragen werden nicht berechnet. Kapazität und Preis sind getrennte Fragen; für Letzteres finden Sie die Tokenpreise hier unserem Preisleitfaden für die Claude API.

Häufig gestellte Fragen

Ist der Fehler 529 meine Schuld?

Nein. Es handelt sich um ein Kapazitätsproblem auf Seiten des Anbieters. Ihre einzigen Pflichten sind, das Problem nicht zu verstärken (Backoff mit Jitter) und eine Ausweichmöglichkeit zu haben, falls der Vorfall länger als Ihr Latenzbudget dauert.

Was ist der Unterschied zwischen 529 und 429?

429 bedeutet, dass Sie Ihre Limits überschritten haben; 529 bedeutet, dass der Server überlastet ist. Beide können wiederholt werden, aber nur 429 enthält normalerweise einen retry-after-Hinweis.

Wird mir eine Anfrage mit 529 berechnet?

Das sollte nicht passieren — die Anfrage hat keine Token erzeugt. Bei Kunavo werden fehlgeschlagene Anfragen nicht vom Guthaben abgezogen.