Claude API timeout (la solicitud agotó el tiempo de espera)
¿Hay una caída ahora mismo?
El estado oficial de Claude API es operativo. Si este error persiste, probablemente sea un problema de implementación o de tu entorno.
Ver el estado de Claude API →Qué significa este error
La solicitud no se completó dentro del límite de tiempo. Pueden causarlo generaciones largas, entradas grandes, una red inestable, sobrecarga del servidor o un timeout demasiado corto en el cliente o el proxy.
Causas comunes
- •Generación larga que no termina a tiempo
- •Entrada grande (contexto largo / muchos tokens) que tarda en procesarse
- •Red inestable entre tú y la API
- •Sobrecarga del lado de Anthropic (a menudo acompañada de un 529)
- •Timeout del cliente o del proxy/gateway configurado demasiado corto
Cómo solucionarlo
- 1.Usa streaming (stream: true) para recibir los tokens a medida que se generan
- 2.Reduce max_tokens y recorta la entrada/el contexto
- 3.Aumenta el timeout del cliente y del proxy
- 4.Reintenta con backoff exponencial
- 5.Revisa la red y cualquier gateway/proxy situado delante de la API
Cuándo conviene esperar (y cuándo no)
Si se debe a sobrecarga, mejora con el tiempo. Si es constante, pásate a streaming y aumenta los timeouts: las generaciones largas sin streaming suelen chocar con los límites del gateway.
Alternativas cuando Claude API está caído
Errores relacionados
Preguntas frecuentes
¿Qué es Timeout (request timed out)?
La solicitud no se completó dentro del límite de tiempo. Pueden causarlo generaciones largas, entradas grandes, una red inestable, sobrecarga del servidor o un timeout demasiado corto en el cliente o el proxy.
¿Cómo soluciono Timeout (request timed out)?
Usa streaming (stream: true) para recibir los tokens a medida que se generan / Reduce max_tokens y recorta la entrada/el contexto / Aumenta el timeout del cliente y del proxy / Reintenta con backoff exponencial / Revisa la red y cualquier gateway/proxy situado delante de la API