Claude API timeout (request timed out · sem resposta)
Há uma queda agora?
O status oficial de Claude API está operacional. Se este erro persistir, provavelmente é um problema de implementação ou do seu ambiente.
Ver o status de Claude API →O que este erro significa
A requisição não foi concluída dentro do limite de tempo. Gerações longas, entradas grandes, rede instável, sobrecarga do servidor ou um timeout de cliente/proxy curto demais podem causar isso.
Causas comuns
- •Geração longa que não termina a tempo
- •Entrada grande (contexto longo / muitos tokens) e lenta de processar
- •Rede instável entre você e a API
- •Sobrecarga do lado da Anthropic (muitas vezes acompanhada de 529)
- •Timeout do cliente ou do proxy/gateway configurado curto demais
Como resolver
- 1.Use streaming (stream: true) para receber os tokens conforme são gerados
- 2.Reduza max_tokens e enxugue a entrada/contexto
- 3.Aumente o timeout do cliente e do proxy
- 4.Repita com backoff exponencial
- 5.Verifique a rede e qualquer gateway/proxy que esteja na frente da API
Quando esperar ajuda (e quando não)
Se for por sobrecarga, melhora com o tempo. Se for consistente, mude para streaming e aumente os timeouts: gerações longas sem streaming costumam esbarrar nos limites do gateway.
Alternativas quando Claude API está fora do ar
Erros relacionados
Perguntas frequentes
O que é Timeout (request timed out)?
A requisição não foi concluída dentro do limite de tempo. Gerações longas, entradas grandes, rede instável, sobrecarga do servidor ou um timeout de cliente/proxy curto demais podem causar isso.
Como resolvo Timeout (request timed out)?
Use streaming (stream: true) para receber os tokens conforme são gerados / Reduza max_tokens e enxugue a entrada/contexto / Aumente o timeout do cliente e do proxy / Repita com backoff exponencial / Verifique a rede e qualquer gateway/proxy que esteja na frente da API