Claude API 请求大小限制从 32 MB 提高到 128 MB
Claude API 请求大小限制提高到 128 MB，是原来的四倍，一次调用能放进更多 PDF 和图片。来看看新限制适用于哪些平台。
本文的其他语言版本：العربيةDeutschEnglishEspañolFrançaisItaliano日本語Polski
Anthropic 把 Messages API 和 Token Counting API 的请求大小限制从 32 MB 提高到了 128 MB。这项变化适用于 Anthropic 直接运营的 Claude API，已写入 Claude Release Notes 10 月 28 日的条目。
Claude API 请求大小限制提到 128 MB，改变了什么？
说白了，就是在 API 返回 413 request_too_large 错误之前，一次 POST /v1/messages 调用能塞进多少数据。计入限制的是整个请求：文本、对话历史，以及以 base64 发送的图片和 PDF。
根据视觉功能文档，单张图片最大 10 MB（base64 编码后），一次 API 请求最多可放 600 张图片（上下文窗口为 20 万 token 的模型为 100 张）。在旧限制下，几张大图就可能用光 32 MB，离图片数量上限还差得远。现在余量是原来的四倍。
PDF 也一样。根据 PDF 支持页面，一次请求最多 600 页（请求的上下文窗口小于 100 万 token 时为 100 页），页数和大小两项限制都针对整个请求。像 Claude for Legal 瞄准的那类长合同或带图的扫描件，现在更容易一次性发送。
新限制在哪里生效？
只在 Anthropic 运营的 Claude API 上（即所谓的“第一方” API）。API 概览中的最新表格如下：
| 端点 | 最大请求大小 |
|---|---|
| Messages, Token Counting | 128 MB |
| Message Batches API | 256 MB |
| Files API | 500 MB |
| Sessions, Agents, Environments | 32 MB |
其他平台的限制不同：
- Amazon Bedrock：20 MB。
- Claude Models on Google Cloud（由 Google 管理）：30 MB。
- Claude Platform on AWS、Claude Models on Google Cloud（由 Anthropic 管理）和 Microsoft Foundry：Messages 和 Token Counting 仍为 32 MB。
API 错误说明里有个小细节：在 Claude API 上，413 错误是由 Cloudflare 返回的，请求根本还没到达 API 服务器。
还需要绕道 Files API 吗？
不一定不需要。文档仍然建议通过 Files API 上传大型 PDF 和大量图片，再用 file_id 引用。在那里单个文件最大 500 MB，整个组织有 1 TB 存储空间。
还有一些限制不会因为上限提高而改变：
- 请求中包含超过 20 张图片时，每张图片都受更严格的尺寸限制。文档建议长边不超过 3000 px，或者把图片和文档块控制在 20 个以内。
- 内容密集的 PDF 即使走 Files API，也可能在达到页数上限之前就占满上下文窗口。
- Claude Managed Agents 中的智能体（Sessions、Agents、Environments）仍为 32 MB。
（请求大小不等于成本：每张图片、每页 PDF 都会变成 token，所以值得看看实际用了多少，就像我做的 Claude Code token 用量测量。）
需要注意什么？
第一，看平台。如果你通过 Bedrock、Google Cloud 或 Foundry 使用 Claude，什么都没变，在 Claude API 上能跑的代码，到了那边可能会收到 413。
第二，用好 token counting。128 MB 的限制同样适用于 Token Counting API，所以大请求可以先数一下 token 再发送。
第三，细节缺失。Release Notes 里的条目只有一句话，没有说明为什么现在提高限制，也没说合作伙伴平台的限制会不会跟着变。
常见问题
Claude API 的最大请求大小是多少？
在 Anthropic 运营的 Claude API 上：Messages 和 Token Counting 为 128 MB，Message Batches 为 256 MB，Files API 为 500 MB。Sessions、Agents 和 Environments 为 32 MB。
Claude API 中的 413 request_too_large 错误是什么意思？
表示请求超出了该端点的字节数上限。解决办法是缩小图片、拆分文档，或者通过 Files API 上传文件并用 file_id 引用。
128 MB 限制在 Amazon Bedrock 上有效吗？
没有。根据文档，Bedrock 的限制是 20 MB，Claude Platform on AWS 的 Messages 和 Token Counting 为 32 MB。
一次请求能给 Claude 发送多少页 PDF？
最多 600 页；请求的上下文窗口小于 100 万 token 时最多 100 页。同时，整个请求必须在大小限制之内。