Claude API timeout（request timed out · 逾時無回應）
現在有故障嗎？
Claude API 官方狀態正常。若此錯誤持續出現，多半是實作或你的運作環境問題。
查看 Claude API 的運作狀態 →錯誤含義
請求未在時限內完成。生成過長、輸入過大、網路不穩、伺服器過載，或用戶端／代理的逾時設定過短，都可能造成此情況。
常見原因
- •生成內容過長，無法在時限內完成
- •輸入過大（長上下文／大量 token）導致處理緩慢
- •你與 API 之間的網路不穩定
- •Anthropic 端過載（常伴隨 529）
- •用戶端或代理／閘道的逾時設定過短
解決方法
- 1.使用串流（stream: true），在生成的同時接收 token
- 2.調降 max_tokens 並精簡輸入／上下文
- 3.延長用戶端與代理的逾時時間
- 4.搭配指數退避（exponential backoff）重試
- 5.檢查網路，以及位於 API 前端的任何閘道／代理
何時該等待 / 等待也無濟於事的情況
若是過載造成的，會隨時間改善。若持續發生，請改用串流並調高逾時時間，非串流的長時間生成很容易撞上閘道上限。
Claude API 當機時的替代方案
相關錯誤
常見問題
Timeout (request timed out) 是什麼？
請求未在時限內完成。生成過長、輸入過大、網路不穩、伺服器過載，或用戶端／代理的逾時設定過短，都可能造成此情況。
Timeout (request timed out) 如何解決？
使用串流（stream: true），在生成的同時接收 token / 調降 max_tokens 並精簡輸入／上下文 / 延長用戶端與代理的逾時時間 / 搭配指數退避（exponential backoff）重試 / 檢查網路，以及位於 API 前端的任何閘道／代理