APIMODELSAPIMODELS

Claude API 529 Overloaded 是什么意思

更新于 2026-11-19

TL;DR 一句话:529 overloaded_error 是所有用户的访问量太大,Anthropic 的 API 暂时过载了。你的请求没问题,也不是你的限流。按指数退避重试,换一个 Claude 型号(容量按型号分开算),或者改用会在第二条线路上重试的接口。

模型页: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 CodeAPI Error: Repeated 529 Overloaded errors,出现前 Claude Code 已经自动重试了最多 10 次
官方 SDKSDK 自己重试完(默认两次)之后抛出过载错误

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。

相关阅读

收录于
APIMODELS on Product HuntAPIMODELS featured on ToolifyAPIMODELS featured on There's An AI For That