服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 新用量和成本端点仍处于 beta,请求需要指定 beta 请求头,旧接口继续受支持。
- Claude Console 与 Claude Enterprise 的报表凭据要求不同。
- 迁移旧日报需要显式指定时间桶,按日期和维度重组并读完所有分页。
- 数据通常在 4 小时内刷新,可能需要 24 小时。月度终值应选择结束至少 7 天的月份。
先核对组织和查询权限
Anthropic 10 月 29 日公布的 beta 接口为 GET /v1/organizations/analytics/usage 和 GET /v1/organizations/analytics/cost。每次请求附上 anthropic-beta: analytics-usage-cost-2026-08-24。旧 Usage and Cost API 和 Enterprise 的旧报表端点仍受支持,可以保留旧链路做对照。
Claude Console 组织使用 Admin API 凭据。Claude Enterprise 组织需要先开通 Analytics API,再由主要所有者在 claude.ai 创建带 read:analytics 范围的密钥。确认数据采集用的是目标组织已有授权,别把密钥写进报表、错误日志或共享表格。
旧日报怎样在新接口中重建?
旧接口按时间桶组织结果,新接口返回按指标排序的行。行里 starting_at 和 ending_at 表示时段,group 放分组维度,usage 或 cost 放指标。迁移日报时显式设置 time_bucket_width=1d,沿用同一组分组维度。默认排序不能当作按日期排列。
按时间输出时可设置 order_by=time 和 order=asc。继续分页直到获取完整结果,再按 starting_at 和分组字段汇总。同一次分页查询使用同一数据快照,页间的 data_refreshed_at 应一致。日报对账时,比较双方同一个 UTC 时段、同一筛选范围和同一指标。
查不到某个日期或维度,先排除什么?
先看 data_refreshed_at。请求范围在该时间之后的部分可能尚未处理或数据不全。若整个请求范围还没有可用数据,返回的刷新时间可以是 null,同时 data 为空。即使看起来已过数小时,也要以实际刷新时间为准。
再检查过滤值和组织范围。新接口遇到个别未知标识或拼错的模型名,过滤可能直接匹配不到结果。group 里的 null 也可能表示未请求该分组或这条记录没有该维度。只有确认范围已刷新、过滤匹配且分页读完后,才在展示层按时间表为确认没有用量或成本的桶补零。
怎样选用于核对的报表窗口?
查询开始时间包含在范围内,结束时间不包含。使用按日时间桶时,用 UTC 日界线对齐两端时间。新接口一次最多查 31 天,较长时段拆成依次衔接的窗口,避免漏算或重复算同一天。
重复核查时,将结束时间设在已看到的 data_refreshed_at 或之前,让比较窗口先保持固定。Anthropic 说明晚到的数据仍可改变月度数值。要取月度终值,选结束至少 7 天的自然月,并保存快照时间和组织范围。
资料来源
常见问题
为什么旧报表有数据,新报表还没有?
两套接口的刷新节奏不同。先检查新报表的 data_refreshed_at 是否已覆盖对应时间,再检查权限、UTC 区间和筛选维度,最后对比同一指标。
只需要某个时段的总用量,要设置每日时间桶吗?
如果既不需要按天也不需要按维度拆分,可以省略 time_bucket_width 和 group_by。匹配范围有数据时,新接口会返回整个请求范围的合计行。