Claude API 529 overloaded_error——它是什麼，以及如何撐過去

529 是唯一不是由你的程式碼造成的 Claude 錯誤：Anthropic 本身過載。你無法修復它，只能妥善承受。這表示要耐心重試、準備備援模型，絕不要用立即重試風暴放大事故。

錯誤

response (HTTP 529)

{
  "type": "error",
  "error": { "type": "overloaded_error",
             "message": "Overloaded" }
}

原因與解決方法一覽

原因	解決方法
提供者端飽和（發布日、區域性故障）	使用帶抖動的退避；請查看提供者狀態頁面，而不是重新部署應用程式。
你的突發流量落在輕微事故期間	分散批次工作；延後 10 分鐘通常就能清除問題。

像負責任的使用者一樣重試

將 529 視為沒有 retry-after 的 429：從約 2 秒開始指數退避、加入抖動、上限 30～60 秒，約 5 次嘗試後放棄並將工作加入佇列。我們 429 指南中的退避程式碼片段會在同一分支處理 529。

切換，而不是失敗

對延遲敏感的路徑定義備援：同系列（Sonnet → Haiku）可保持相近行為；跨提供者（Claude → GPT）可撐過整個提供者的故障。在 OpenAI 相容端點上，只需更換一個字串：

failover.py

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 last

如果你透過 Kunavo 呼叫

Kunavo 會透過多條上游路徑路由 Claude，多模型目錄讓跨提供者備援變成在同一個金鑰與錢包下更換模型字串——上述備援模式不需要第二個帳戶。傳達到你這裡的 529 仍然不會計費。容量與價格是兩個不同的問題；至於後者，各模型的單價列於 Anthropic Claude API 價格表.

常見問題

529 是我的錯嗎？

不是。這是提供者端的容量問題。你唯一的責任是不放大事故（退避、抖動），並在故障超過延遲預算時準備可切換的去處。

529 與 429——有什麼差異？

429 表示你超過了自己的限制（伺服器正常）；529 表示伺服器本身過載（你的配額正常）。兩者都可重試，只有 429 會附帶 retry-after 提示。