Inicio → Ayuda

529 overloaded_error de Claude: qué es y qué hacer

Lo que ves

• 529 {"type":"error","error":{"type":"overloaded_error"}}
• anthropic.InternalServerError: Error code: 529
• Bursts of failures that clear on their own within minutes
• Retrying immediately produces another 529

Por qué ocurre

Es una condición del lado del servidor ligada a la demanda del modelo, normalmente concentrada en los modelos más nuevos y grandes en horas punta. Nada en tu petición la provoca.

A menudo se confunde con el 429. Son problemas opuestos: 429 significa que tú enviaste demasiado, 529 que el proveedor tiene demasiado de todos. Reducir tu propio tráfico no despejará un 529 más rápido, pero reintentar al instante te convierte en parte de la avalancha.

A través de una pasarela el panorama es el mismo, con un añadido: si la pasarela tiene varias cuentas upstream, un 529 en una de ellas puede reintentarse en otra antes de que llegues a verlo.

Cómo solucionarlo

1. Reintenta con backoff exponencial y jitterEspera aproximadamente 1, 2, 4, 8 segundos con un desfase aleatorio. El jitter importa: los reintentos sincronizados de todos los clientes a la vez son lo que mantiene viva la sobrecarga.
2. Ten un modelo de respaldo para el trabajo que lo admitaLos trabajos por lotes y en segundo plano pueden pasar a un modelo más pequeño ante un 529 en lugar de fallar. A las peticiones interactivas normalmente les conviene esperar.
3. No lo trates como un problema de facturaciónRecargar, rotar claves o subir límites no cambia nada aquí. Si persiste más de unos minutos, consulta la página de estado del proveedor.

Relacionado

Revisado por última vez el 2026-10-01. Escrito a partir de problemas diagnosticados en una pasarela compatible con OpenAI en producción, no recopilado de otras webs.