Claude API 529 Overloaded 是什么意思
更新于 2026-11-19
模型页:Claude Sonnet 5.5 API —— 价格、规格与在线体验
Anthropic 的错误文档对 529 overloaded_error 只有一句话:API 暂时过载,在所有用户访问量都很大时会出现。这就是它和 429 最大的区别:429 和你的账号有关,529 和 Anthropic 那一刻的容量有关,所以它常常在高峰时段和新模型刚发布时成片出现。
在 Claude Code 里,它会在自动重试用完之后显示为「API Error: Repeated 529 Overloaded errors」。Claude Code 文档写得很明确:529 不是你的用量上限,也不占你的额度。直接调 API 时,它还可能在流式回答进行到一半时,以名为 overloaded_error 的错误事件出现。
529 长什么样
| 出现在哪 | 你会看到 |
|---|---|
| 直接调 API,非流式 | HTTP 529,内容是 {"type": "error", "error": {"type": "overloaded_error", "message": "Overloaded"}},外加请求 id |
| 直接调 API,流式 | 先回 HTTP 200,随后流里来一个名为 error 的事件,error.type 是 overloaded_error |
| Claude Code | API Error: Repeated 529 Overloaded errors,出现前 Claude Code 已经自动重试了最多 10 次 |
| 官方 SDK | SDK 自己重试完(默认两次)之后抛出过载错误 |
529 的处理办法,按顺序来
1. 等一会儿,按指数退避重试。 529 是暂时的。SDK 会自动退避;自己写的代码每次把等待时间翻倍,再加一点随机,别让大量客户端同一时刻一起重试。
2. 换型号。 容量按型号分开算,Sonnet 过载时 Opus 或 Haiku 不一定过载。Claude Code 里用 /model 切换。
3. 持续几分钟以上就看 status.claude.com。
4. 无人值守的任务,让 Claude Code 一直重试。 设置 CLAUDE_CODE_RETRY_WATCHDOG=1,它会对 429 和 529 这类容量错误无限重试,适合 CI。CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS(默认 500)和 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS(默认 32000)用来调退避时间。
5. 流到一半报错也要接住。 如果 overloaded_error 以流里的事件出现,留住已经收到的部分,再让模型接着写。
529 不是什么
它不是限流,所以降低请求频率帮助不大;也不是你的提示词、key 或套餐造成的。它也不代表你的钱被花掉了:在 Claude Code 里不占你的额度;按 token 付费的接口上,失败的请求没有产出完整回答。
为什么在 APIMODELS 上更少看到 529
在 APIMODELS 上,现役的每个 Claude 型号(Fable 5.2、Opus 5.5、Sonnet 5.5、Haiku 5.5)都至少有两条上游线路。第一条线路在开始回内容之前返回 429、5xx 或者连不上,请求会自动换到下一条,只有所有线路都失败了你才会看到报错,失败的请求不扣费。有一点我们也绕不过去:回答一旦开始流式返回,中途出的错没法再换线路,只能以流里的错误事件交给你。
所以一条线路在开始回答之前回的 529,通常会被下一条线路接住,你的代码察觉不到。仍然可能看到 529 的情况有两种:所有线路同一时刻都过载,或者回答已经开始之后才过载、变成流里的错误。把 Anthropic SDK 或 Claude Code 的地址改成 https://api.apimodels.app,模型名照旧。
调用示例
cURL
curl https://api.apimodels.app/v1/messages \
-H "x-api-key: $APIMODELS_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"stream": true,
"messages": [{"role": "user", "content": "Summarise this error log in three bullet points."}]
}'Python
import anthropic
# Same Anthropic SDK, pointed at APIMODELS. The SDK already retries 408/409/429/5xx
# with exponential backoff (twice by default); raise it for batch jobs.
client = anthropic.Anthropic(
base_url="https://api.apimodels.app",
api_key="sk_...your_apimodels_key...",
max_retries=4,
timeout=600,
)
try:
with client.messages.stream(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Summarise this error log in three bullet points."}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
except anthropic.APIStatusError as e:
# e.status_code: 429 / 500 / 529 ...; the body carries error.type and a request id
print("failed:", e.status_code, e.response.headers.get("request-id"), e.message)常见问题
Claude API 报 529 是什么意思?
529 overloaded_error 表示所有用户的访问量太大,Anthropic 的 API 暂时过载。你的请求没有问题,也不是你的限流。按指数退避重试,或者换一个 Claude 型号,因为容量是按型号分开算的。
Claude 为什么会过载?
因为那一刻所有用户对这个型号的需求超过了 Anthropic 的容量,高峰时段和新模型刚发布时最常见。这是 Anthropic 那边的容量问题,改提示词或换 key 都解决不了。
529 会占用我 Claude Code 的用量额度吗?
不会。Claude Code 的错误文档写明,529 不是你的用量上限,也不计入你的额度。Claude Code 会先自动重试最多 10 次,之后才显示「Repeated 529 Overloaded errors」;这时等一会儿,或者用 /model 换型号。
Claude 的 529 一般持续多久?
通常是几分钟,不是几小时,但 Anthropic 没有公布具体数字。持续超过几分钟就去看 status.claude.com。无人值守的任务可以设置 CLAUDE_CODE_RETRY_WATCHDOG=1,让 Claude Code 对 529 一直重试,而不是停下来。
能完全避免 529 吗?
没法完全避免,因为它反映的是 Anthropic 的容量。但能大大减少:在 APIMODELS 上,现役 Claude 型号都至少有两条上游线路,回答开始前的 529 会自动换下一条重试。所有线路同时过载时,你仍然可能看到 529。
