Anthropic 发布了测试版使用情况和成本分析 API,为组织提供了一种第一方方法来检索详细的 Claude 使用情况和支出数据。该界面于 10 月 29 日发布,添加了用于使用情况和成本报告的单独端点,维度包括模型、工作区、API 键、服务层和个人参与者。

此次发布的重要性超出了财务团队导出另一份报告的范围。多模型网关、内部人工智能平台和经销商通常需要将提供商记录转化为客户发票、团队退款和保证金报告。 Anthropic 的新 API 提供了执行此操作所需的更多基础数据,而无需完全依赖从推理响应重建的令牌计数。

Anthropic 发布了哪些内容

测试版公开了两个组织级 GET 端点:/v1/organizations/analytics/usage 用于消费记录,/v1/organizations/analytics/cost 用于财务数据。请求必须包含 Beta 标头analytics-usage-cost-2026-08-24。

组织可以跨多个运营维度对结果进行过滤或分组。 Anthropic 的文档列出了可用字段中的模型、工作区、API 密钥、服务层、用户和服务帐户。报告可以包含令牌和请求计数以及实际价格和标价成本。

当合同费率、折扣或其他特定于帐户的经济因素导致简单的公开价格计算不准确时,实际价格成本和标价成本之间的区别特别有用。它还可以帮助运营商将其产生的提供商费用与内部报告或面向客户的计费中使用的参考价格分开。

API 处于测试阶段,因此不应将其视为不可变的会计合同。集成需要固定所需的标头,根据现有发票验证返回的总计,并容忍与测试版服务一致的更改。

为什么网关和经销商应该关心

网关可以记录请求的模型、报告的令牌以及对每次调用负责的客户。本地账本仍然很重要,但它可能无法完全解释提供商的最终费用。服务层级、帐户特定定价和提供商端调整可能会导致估算费用与最终计费金额之间存在差异。

Anthropic 的费用端点会创建额外的调节源。平台可以将其请求分类账与组织级提供商记录进行比较,调查差异并使用实际成本数据计算利润。对于 AI API 经销商运营,这可以改善客户退款并使意外成本变动更容易隔离。

API-关键和参与者维度在运营上也很重要。它们允许将报告划分为凭据、用户和服务帐户,而不是停留在工作区范围内的总数。组织可以使用这些部门来识别异常昂贵的密钥、归属共享 Claude 支出或通过更精确的报告支持内部预算所有者。

这并不能消除对网关端计量的需求。提供商分析描述Anthropic消费,而多提供商平台必须在供应商之间保留一致的记录,并保留只有网关知道的客户、项目或产品上下文。更强大的设计是在这些分类帐之间进行协调,而不是用另一个分类帐来替换。

旧集成现在面临迁移决策

Anthropic 已将其早期的使用和成本 API 和多个 Claude 企业报告端点标记为旧版本。该公司表示,这些接口仍受支持,因此这不是立即关闭通知。不需要仅仅因为存在测试版就删除现有集成。

团队仍应在选择迁移日期之前将新的 API 与其当前导出进行比较。即使两个界面报告大致相似的信息,分页、数据新鲜度和分组行为也会影响下游作业。类似于端点替换的更改可能需要更新架构、聚合逻辑和历史比较。

临时运行两条路径可以让组织按天、模型和工作区比较总数。在 Beta 版数据成为发票、客户报表或自动 AI API 支出控制的基础之前,应了解重大差异。

多模型报告的更高标准

该版本还提高了对网关分析的期望。客户越来越需要的不仅仅是象征性的总数:他们需要请求和收费的模型、服务级别、凭证所有权、提供商成本以及向客户提供的价格。第一方报告维度使网关自己的账本中的遗漏更加明显。

对于 Model Gate 等平台,实际的机会是使用提供商分析作为统一 AI API 计费 中的对账输入。提供商 Feed 可以验证 Claude 费用,而网关则继续规范供应商之间的使用情况,并将其与团队、客户和托管 API 密钥相关联。

仍然不确定的是测试版合同的稳定性以及其记录与不同帐户安排的最终计费的一致性。在这些问题在生产中得到测试之前,最好将新端点视为有价值的会计来源,并对其进行调节控制,而不是作为唯一的记录分类账。