Erreur Claude 529 (overloaded_error) : causes et solutions

529 est la seule erreur Claude qui ne provient pas de votre programme : c’est l’infrastructure d’Anthropic qui est saturée. Vous ne pouvez pas la réparer ; vous pouvez seulement la gérer correctement — nouvelles tentatives patientes avec temporisation, modèle de secours pour les chemins sensibles à la latence, et surtout aucune répétition immédiate en rafale qui amplifierait la panne.

L’erreur

回應（HTTP 529）

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

Causes et solutions en bref

Cause	Solution
Surcharge du fournisseur (jour de lancement d’un nouveau modèle, panne régionale). Tous les clients la subissent simultanément.	Attendez avec une temporisation avec gigue ; consultez la page d’état d’Anthropic plutôt que de redéployer votre application.
Votre pic de trafic coïncide avec une capacité déjà sous tension.	Répartissez les travaux par lots dans le temps ; un délai de dix minutes suffit généralement.
Confusion avec 429. Dans les journaux, les deux se ressemblent, mais leurs causes sont totalement différentes.	429 signifie que vous avez dépassé votre propre limite (serveur sain) ; 529 signifie que le serveur est lui-même surchargé (votre quota est correct). Seul 429 inclut un indice Retry-After.
Aucun secours n’est défini, si bien que le problème du fournisseur atteint directement les utilisateurs finaux.	Définissez d’abord l’ordre des secours — au sein de la même famille (Sonnet → Haiku), le comportement est plus proche ; entre fournisseurs (Claude → GPT), vous pouvez survivre à une panne de toute l’infrastructure.

Empêcher les nouvelles tentatives d’amplifier la panne

Traitez 529 comme un « 429 sans Retry-After » : temporisation exponentielle à partir d’environ 2 secondes, avec gigue, plafonnée à 30–60 secondes ; après environ cinq tentatives, abandonnez et placez le travail en file d’attente. La gigue est l’élément réellement efficace : sans elle, tous les clients reviennent au même instant et prolongent exactement la congestion qu’ils tentaient de fuir.

Ne tombez pas en panne, contournez-la

Définissez à l’avance une chaîne de secours pour les chemins sensibles à la latence. Sur un endpoint compatible OpenAI, il suffit de modifier une chaîne — inutile d’intégrer un autre SDK ou d’ouvrir un autre compte :

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          # 過載 —— 試下一個
    raise last

Ne suspectez votre programme qu’en dernier recours

Si un seul type de requête renvoie 529 alors que les autres appels passent au même moment, il ne s’agit pas d’une panne générale : vérifiez si ce chemin envoie un prompt anormalement volumineux ou émet des requêtes successives dans une boucle très courte. À l’inverse, si tous les appels commencent simultanément à renvoyer 529 puis redeviennent normaux, la cause est la capacité — il faut agir sur les nouvelles tentatives et le secours, pas refactoriser.

Si vous appelez via Kunavo

Kunavo répartit Claude sur plusieurs chemins amont, et le catalogue multi-modèles transforme le secours inter-fournisseurs en « même clé, même solde, seul le nom du modèle change » — le code ci-dessus n’a pas besoin d’un second compte. Même si un 529 vous parvient encore, il n’est jamais facturé. La capacité et le prix sont deux questions distinctes ; pour ce dernier, le prix unitaire de chaque modèle figure dans le tableau des tarifs de l’API Claude.

Questions fréquentes

529 est-il de mon fait ?

Non. Il s’agit d’un problème de capacité côté fournisseur. De votre côté, vous devez seulement éviter d’amplifier la panne (temporisation et gigue) et disposer d’une route de contournement lorsque la panne dépasse votre budget de latence.

Quelle est la différence entre 529 et 429 ?

429 signifie que vous avez dépassé votre propre limite et que le serveur est sain ; 529 signifie que le serveur est lui-même surchargé et que votre quota est correct. Les deux peuvent être retentés, mais seul 429 inclut un indice Retry-After.

Combien de temps 529 dure-t-il généralement ?

C’est imprévisible et aucune garantie n’est possible — la bonne réponse est donc « temporisation plafonnée et file d’attente », et non un délai d’attente codé en dur. Si ce chemin possède un budget de latence, le secours doit prendre le relais plutôt que d’attendre.

Les appels échouant avec 529 sont-ils facturés ?

Pas via Kunavo : les requêtes qui se terminent par une erreur ne sont pas incluses dans la facturation. Si vous avez un contrat direct avec le fournisseur, cela dépend de ses règles de facturation.

Guides associés

La sémantique détaillée des erreurs est disponible dans référence des erreurs ; obtenir une clé prend une minute via inscription et la guide d’authentification.

Erreur Claude API 529 overloaded_error — ce que cette erreur signifie et comment la surmonter