Claude API 上线 Usage and Cost Analytics API 测试版，可按模型、API Key、调用者拆分用量与成本；单次请求上限提到 128 MB

核心背景与行业痛点

团队把 Claude 接进产品、内部工具和 agent 之后，最常见的问题是「钱花在哪了」：哪个 API Key、哪个工作区、哪个服务账号用得最多，按天或按小时怎么变化。原来的 Usage and Cost API 和 Enterprise 的用量报表维度有限，Console 和 Enterprise 两类组织还要分别对接。另一个痛点是请求体大小：带大量图片、PDF 或长上下文的请求容易超过 32 MB 上限。

架构亮点与底层机制

据官方更新日志，10 月 29 日推出的 Usage and Cost Analytics API（测试版，beta 头 analytics-usage-cost-2026-08-24）有两个端点：/v1/organizations/analytics/usage 返回 token 数和请求数，/v1/organizations/analytics/cost 返回美元成本。按官方文档，可以用模型、工作区、API Key、服务等级以及具体调用者筛选和分组，group_by 最多 5 个维度；时间桶可选 1 分钟、1 小时或 1 天，结果默认按指标排序，方便直接找出最大消耗方。成本端点还能按成本类型和 token 类型拆分。Console 组织用 Admin API Key 或带 org:admin 的 OAuth 令牌，Enterprise 组织用 read:analytics 权限的 Key。旧接口转为 legacy，但继续支持。10 月 28 日，第一方 Claude API 的 Messages 和 Token Counting 接口单次请求上限从 32 MB 提到 128 MB。

权威 Benchmark 与实测跑分对比

这是平台和计费工具更新，不涉及模型能力，没有跑分。官方未公布数据的延迟时间和历史数据可查范围。

开发者实战落地与开箱指南

如果你在做内部成本看板，可以直接用官方 SDK 的 client.beta.organization.analytics.usage.list 按天、按模型拉取数据，SDK 会自动带上 beta 头并翻页。建议给采集服务单独建一个 Admin Key 并定期轮换，或按官方建议用 Workload Identity Federation 换取短期令牌。原来用 usage_report、cost_report 的集成可以按官方迁移指南切换。需要一次发送大量图片或文档的应用，现在第一方 API 可以发到 128 MB，但云厂商渠道的限制要另查文档。