La 529 est l’erreur Claude que votre code n’a pas provoquée : Anthropic est lui-même en surcharge. Vous ne pouvez pas la corriger ; vous pouvez seulement l’absorber correctement. Cela implique des nouvelles tentatives patientes, un modèle de secours et l’interdiction d’amplifier l’incident par des vagues de nouvelles tentatives immédiates.
L’erreur
{
"type": "error",
"error": { "type": "overloaded_error",
"message": "Overloaded" }
}Causes et solutions en bref
| Cause | Solution |
|---|---|
| Saturation du côté du fournisseur (jours de lancement, incidents régionaux) | Utilisez une temporisation avec gigue ; consultez la page d’état du fournisseur au lieu de redéployer votre application. |
| Votre rafale est survenue pendant un incident limité | Répartissez les travaux par lots ; un délai de 10 minutes suffit généralement à résoudre le problème. |
Effectuer des nouvelles tentatives correctement
Traitez la 529 comme une 429 sans Retry-After : temporisation exponentielle à partir d’environ 2 s, gigue, plafond à 30–60 s, abandon après environ 5 tentatives et mise en file du travail. L’extrait de temporisation de notre guide sur la 429 traite la 529 dans la même branche.
Basculer plutôt que laisser échouer
Pour les chemins sensibles à la latence, définissez un mécanisme de secours : une même famille (Sonnet → Haiku) conserve un comportement proche ; un changement de fournisseur (Claude → GPT) résiste à une panne complète du fournisseur. Avec un endpoint compatible OpenAI, il suffit de modifier une chaîne :
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 lastSi vous appelez via Kunavo
Kunavo achemine Claude sur plusieurs chemins en amont et son catalogue multimodèle permet le basculement entre fournisseurs par un simple changement de chaîne de modèle, avec la même clé et le même portefeuille — le mécanisme de basculement ci-dessus ne nécessite aucun deuxième compte. Les erreurs 529 qui vous parviennent ne sont toujours jamais facturées. La capacité et le prix sont deux questions distinctes ; pour la seconde, les tarifs par modèle figurent dans la grille tarifaire de l’API Anthropic Claude.
Questions fréquentes
La 529 est-elle de ma faute ?
Non. Il s’agit d’un problème de capacité du fournisseur. Vos seules responsabilités sont de ne pas l’amplifier (temporisation et gigue) et de prévoir une voie de secours si l’incident dépasse votre budget de latence.
529 contre 429 — quelle est la différence ?
La 429 signifie que vous avez dépassé vos limites (le serveur fonctionne correctement) ; la 529 signifie que le serveur lui-même est en surcharge (votre quota est normal). Les deux erreurs peuvent faire l’objet d’une nouvelle tentative, mais seule la 429 fournit l’indication retry-after.
Guides associés
- Qu’est-ce qu’une passerelle IA ? Le modèle de passerelle LLM expliqué (2026)
- Claude Code « Response stalled mid-stream » et « Streaming response ended before any complete data was received » — ce qui interrompt le flux
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.