Claude费用分析API进入beta：旧脚本只改地址，为什么可能漏算？

Claude官方发布记录在2026年10月29日宣布Usage and Cost Analytics API进入beta，提供/v1/organizations/analytics/usage和/v1/organizations/analytics/cost。此前的Usage and Cost API及Enterprise相关旧报表接口被列为legacy，仍继续受支持，不能把更新写成旧接口已经关闭。

本文于2026年10月30日核验。新请求需要anthropic-beta: analytics-usage-cost-2026-08-24及anthropic-version头；beta头中的日期不是本次公告发布日期。Console组织使用Admin凭证，Enterprise组织使用启用Analytics API后创建的read:analytics凭证，应先确认自己属于哪条接入路径。

迁移前先写一份查询约定：组织、接口、UTC起止、筛选条件、分组、时间粒度及金额字段。旧报表与新报表不在同一范围时，数值差异无法单独归因于分页。

需要按日观察时，显式设置time_bucket_width=1d，并提供ending_at。不要只根据返回行号给日期定位，也不要在过滤条件变了之后继续沿用旧游标。

以下是固定假设快照的桌面演算，未执行官方API或SDK。假定一个支持workspace分组的Console组织，在两个完整UTC日内有三个workspace；每个workspace每天恰好产生一行费用，没有按cost_type或token_type展开，也没有其他行。

教学查询范围为2026-10-20T00:00:00Z至2026-10-22T00:00:00Z，time_bucket_width=1d、group_by[]=workspace_id、limit=2、order_by=amount、order=desc。起点包含、终点不包含；表里的日期都是UTC桶日期。

全部合计为2100.000000美分，即21美元。只取第一页会得到11美元，少算10美元。第一页已经包含两天，但只覆盖W-A；不能看到两个日期就认定这段期间读全了。

这不是节省成本的案例，也不表示真实查询固定返回三页。分组数量、日期、筛选及展开维度都会改变分页；金额读取应使用十进制或适当整数精度，不能把美分字符串直接展示成美元。

以下是本站建议的采集流程，用于约束报表何时可以更新，不是Claude原生提供的事务或报表状态。官方SDK的自动翻页迭代器与自己只读取一个原始响应对象，也要分清。

官方参考说明，游标可能在数据刷新后过期并返回HTTP 410，届时需从第一页重启。本站建议给重启创建新的暂存批次，隔离前一次未完成批次；不能把两批都追加到同一个合计中。

同一次分页的各页使用同一数据快照。若采集记录显示快照标记不一致，应先排查是否混入其他查询结果，不把这种差异静默合并。

data_refreshed_at表示数据刷新状态。其后的使用量可能缺失或不完整；尚无可用数据时，该字段可为null且data为空。文档称通常约4小时刷新，可能需要24小时，因此当天最后一段数据不宜直接作为已完成期间。

本站建议把“采集成功但数据未就绪”和“完整范围内确认为零”分开。只有在范围、分页和可用性都核对后，才为图表补零；查询失败或未刷新时，显示待更新，而不是生成一条零费用。

金额也有范围：amount是折扣后、抵扣credits之前的数值。Priority Tier承诺覆盖的token费用可以为零，承诺费另计且不在这份数据中。即使分页读完，也不能直接宣称拿到了最终全额账单。

这些检查验证采集逻辑，不验证某项业务是否值得使用AI。要进一步计算成功任务成本，仍需关联工具、基础设施和人工接管等消耗，以及对应的业务结果。

先挑一个实际使用的旧报表脚本，写清它的组织、范围、筛选及输出用途，再用固定样本核对结构与分页。旧接口继续受支持，可以在自己的环境完成比较后再切换；不要把数据延迟误判成采集代码已经正确或错误。

AI随心创的企业AI / FDE服务涉及需求诊断、系统集成与交付。需要讨论用量报表或Agent运行成本时，可准备脱敏查询参数、缺数样例、内部报表口径和消费明细关联方式，用于约定诊断与验收范围。无需在文章评论或沟通资料里提交密钥。