先给结论:10 月 28 日 Anthropic 把直连 Claude API 上 Messages 与 Token Counting 的单次 HTTP 请求体上限从 32 MB 提到 128 MB;10 月 29 日又公测 Usage and Cost Analytics API,用 JSON 行报表 token 与美元成本。128 MB 只算整包请求(提示、历史、base64 文档),不改单张图片或单页 PDF 的既有上限。Analytics 每次要带 anthropic-beta: analytics-usage-cost-2026-08-24,读 data[] 里每行的 group、usage 或 cost,并分页跟 next_page。旧的 Usage and Cost API 与 Enterprise 报表端点改标 legacy,仍可用但有迁移指南。
这篇按 2026 年 10 月 30 日写,依据 10 月 28–29 日发行说明与 Analytics 文档。四天前本站写过《API 版本 2026-10-21 与 temperature 400》。那边改的是请求字段合法性;这边改的是「能塞多大的 JSON 体」以及「账单 JSON 长什么样」。
128 MB 实际覆盖哪些接口
发行说明写明:仅第一方 Claude API 的 Messages 与 Token Counting 从 32 MB 提到 128 MB。Message Batches 仍是 256 MB 上限;Files API 仍是 500 MB;Sessions、Agents、Environments 相关请求仍 cap 在 32 MB。涨价的是「单次 POST 里能带的对话与嵌入 base64 的 PDF/图片总量」,不是模型上下文窗口本身。
| 端点(第一方) | 原上限 | 10 月 28 日后 |
|---|---|---|
| Messages / Token Counting | 32 MB | 128 MB |
| Message Batches | 256 MB | 256 MB |
| Files API | 500 MB | 500 MB |
文档仍保留单资源限制:例如单张图片、单份 PDF 页数或单次请求图片张数的上限并未因 128 MB 而取消。接近新上限时,应先用 Token Counting 估算,而不是假设「文件小于 128 MB 就一定能过」。
为什么 Bedrock 仍是 20 MB
合作伙伴托管平台各自限流。API 概览列出的典型值:Amazon Bedrock 约 20 MB;Google Cloud(Google 托管)约 30 MB;Claude Platform on AWS、Anthropic 托管 Google Cloud、Microsoft Foundry 等多为 32 MB。你在第一方测通的多 PDF 批量抽取,部署到 Bedrock 可能仍在旧 ceiling 上 413 或 400。
多环境流水线应在配置里写 max_request_bytes 按平台分支,而不是写死 128 MB。与《Bedrock 结构化输出》一样,功能 parity 不等于传输上限 parity。
Analytics API 怎么请求
Console 与 Enterprise 组织可用 Admin API 密钥访问:
GET /v1/organizations/analytics/usage— token 与请求次数GET /v1/organizations/analytics/cost— 美元成本(含 list 与折后)
每次请求需要 anthropic-version 与 beta 头 anthropic-beta: analytics-usage-cost-2026-08-24。查询参数常用 starting_at、ending_at、time_bucket_width=1d,以及最多五个 group_by[] 维度(如 model、workspace_id、api_key_id)。
响应分页:has_more、next_page、data_refreshed_at。SDK 读迭代器时会自动翻页;手写 curl 时要循环 next_page 直到 has_more 为 false。
usage 行里几个 token 字段怎么加
每一行有 starting_at、ending_at、group(维度字典)和 usage。没在 group_by[] 里声明的维度在 group 里是 null,不要当成「零用量」。
{
"data": [{
"starting_at": "2026-09-03T00:00:00Z",
"ending_at": "2026-09-04T00:00:00Z",
"group": {"model": "claude-sonnet-5", "workspace_id": null},
"usage": {
"uncached_input_tokens": 1284500,
"cache_creation": {
"ephemeral_5m_input_tokens": 215300,
"ephemeral_1h_input_tokens": 0
},
"cache_read_input_tokens": 3200000,
"output_tokens": 891000,
"total_tokens": 5590800,
"requests": 4210
}
}],
"has_more": true,
"next_page": "page_...",
"data_refreshed_at": "2026-09-18T16:02:11Z"
}
对账时把 cache 写入拆成 5 分钟与 1 小时桶,再与 cache read 分开乘价目。若你同时接 OpenAI Responses 的 ttl_30m_tokens / ttl_12h_tokens,字段名不同,不要混在一个 JSON Schema 里硬映射。
cost 行里 amount 怎么读
cost 端点每行的 cost.amount 文档写的是折后、扣 credit 前的小数美分(fractional cents);list_amount 是折前列表价。货币码目前为 USD。按 cost_type 或 token_type 分组时,requests 可能为 null,文档说明此时请求次数应从未拆分的汇总行读取。
落库建议保留 data_refreshed_at,Analytics 刷新比 legacy Usage and Cost API 慢,同一小时重复拉取可能仍看到旧快照。BI 层用 data_refreshed_at 做水位线,而不是假设「现在拉就是实时账单」。
legacy 报表还要不要接
10 月 29 日公告把原 Usage and Cost API,以及 Enterprise Analytics 的 usage_report、cost_report、user_usage_report、user_cost_report 标为 legacy,并声明仍支持。新集成应走 Analytics;旧管道可并行一段时间,用 JSON Diff 验证同一 starting_at 区间 totals 是否收敛,再切流量。
常见问题 FAQ
128 MB 等于可以把 120 MB 的 PDF base64 一次塞进 messages 吗?
不一定。整包 HTTP 上限提高到 128 MB,但单 PDF、单图片、单次请求图片张数等子限制仍在。还要加上 JSON 结构与 base64 膨胀。先用 Token Counting 验证。
Message Batches 会跟着变成 128 MB 吗?
不会。批次接口维持 256 MB 上限,与 Messages 的 128 MB 是两条线。
Analytics 缺 beta 头会怎样?
与未启用的 beta 能力一样,请求会失败或看不到端点。必须带 analytics-usage-cost-2026-08-24。
group 里全是 null 是不是没数据?
不是。null 常表示该维度未出现在 group_by 中,或该行在该维度无值。看 usage 或 cost 数字是否非零。
amount 字符串要除以 100 才是美元吗?
文档定义 amount 为 fractional cents(小数美分)。换算美元需按文档示例处理小数,不要当成已经是以美元为单位的浮点字符串。
legacy usage_report 会立刻下线吗?
发行说明写仍支持,并给出迁移文档。新功能(更多 group 维度、actor 拆分)只在 Analytics 上扩展。
总结
10 月 28–29 日两件事:更大的第一方请求体,以及更细的账单 JSON。128 MB 别搬到 Bedrock;Analytics 记得 beta 头、分页和 cache 子字段。legacy 报表可以并存,但新 dashboard 应对齐 Analytics 的行模型。