Cloudflare 推出 Billable Usage API：为自助账户提供按产品与计费周期的程序化成本可见性

Agents Week 关注的是正在发生的转变：智能体代表你编写代码、部署 Workers、配置基础设施。这一转变改变了你需要看到的内容。如果某个程序在你的 Cloudflare 账户中花钱，你需要知道它花了什么；全天候、按产品、以另一种程序可以消费的形式呈现。仪表盘是面向人类的正确答案，但不是面向自动化的正确答案。

因此，我们为自助服务账户推出了一款新的 Billable Usage API：一个单一端点，返回你账户的使用量和成本，按产品和计费周期细分。它覆盖账户上所有按用量计费的 Cloudflare 产品，包括 Workers、R2、D1、Workers AI、Vectorize、Images 和 Stream，一次调用即可全部获取。如果你已经在使用 FinOps 工具链，这些列名应该看起来很熟悉。

你将收到 HTTP 200 OK 响应，Content-Type 为 application/json，使用量数据行位于响应体中。目前，使用量和成本数据每日更新，我们正在努力提供更接近实时的数据。

返回内容

响应中的每一行对应你账户上某个产品的一个计费周期。

ServiceName 和 ServiceFamilyName —— 具体是哪个产品（“Workers” 产品族下的 “Workers Standard”、“R2” 下的 “R2 Storage” 等）。

ChargePeriodStart / ChargePeriodEnd —— 该行覆盖的时间窗口。

PricingQuantity 和 ConsumedUnit —— 你的使用量，以我们计费所依据的计量单位表示（GB-月、GB-秒、请求数等）。

ContractedCost —— 该周期产生的费用，以 BillingCurrency 计。

CumulatedPricingQuantity 和 CumulatedContractedCost —— 当前账单周期的累计总计。

ZoneId / ZoneName —— 当使用量归属于特定区域时提供。

其中大部分直接对应 FinOps Open Cost and Usage Specification（FOCUS）中的列，因此如果你的团队已经在从其他提供商摄取 FOCUS 数据，这些名称和语义应该很熟悉：

响应使用标准的 Cloudflare API 封装格式 —— result 是一个行数组，每个产品每个计费周期一行，同时包含 success、errors 和 messages 字段。

我们在 FOCUS 方面的进展

采用 FOCUS 命名是一个深思熟虑的选择。AWS、Azure、Google Cloud、Oracle 以及越来越多的 SaaS 提供商已经在发布 FOCUS 格式的导出文件，而且每一款严肃的成本管理工具都支持这一格式。话虽如此，我们目前还不宣称完全符合规范：规范要求的少数几个列尚未包含在当前的数据负载中。实现完全合规已列入我们的路线图。请将此视为第一步：先采用熟悉的格式，下一步实现完全合规。

Cloudflare 支出，与您的其他云支出并列呈现：我们与 Vantage 的合作

我们已与 Vantage 合作推出了原生 Cloudflare 集成。Vantage 是一个基础设施成本管理平台，它从 30 多家提供商（涵盖 AI、云和 SaaS 提供商）摄取成本与使用数据，并将其整合到单一视图中，用于报告、分摊和优化。通过此集成，您的使用数据会流入您已用于其余基础设施的同一套 Cost Reports、Budgets 和 Cost Alerts 中。

Vantage 通过一个具有 Billing Read 权限的只读 API token 连接到 Cloudflare。连接后，Vantage 每天拉取您的 Billable Usage 数据，并按产品（如 Workers 和 R2）、区域和账户进行细分，以便您了解哪些产品推动了支出，并将其归因到背后的团队和服务。

此集成支持的部分工作流程包括：

跨提供商成本分摊。按产品、区域和账户对 Cloudflare 支出进行分组，然后使用 Virtual Tags 按团队或产品线进行分摊，与您的 AWS、Azure 和其他提供商成本并列，全部呈现在单一报告中。

异常检测。Vantage Cost Alerts 会监控每一个已连接的提供商，并在支出偏离基线时通过 Slack 或电子邮件通知您，因此 Workers 或 R2 支出的变化会以与其他任何提供商相同的方式呈现出来。

FinOps 智能体和 MCP。向控制台内的 Vantage FinOps 智能体提问，例如“上周我们所有提供商中最大的成本驱动因素是什么？”，或者通过 Vantage 托管的 MCP 服务器从 Claude 或 ChatGPT 查询相同的数据。Cloudflare 支出会与您连接的其他提供商数据一并包含在内。

在 Vantage 控制台中连接你的 Cloudflare 账户后，你的费用就会与你运行的其他所有内容并列显示。无需手动导出、无需上传账单、也无需维护单独的控制面板。

这个 FOCUS 标准化 API 同样适用于其他金融科技工具。

我们为什么构建这个功能

智能体不仅能编写代码。它们还能部署 Workers、配置 R2 存储桶、管理 D1 数据库。当你授予对 Cloudflare 账户的程序化访问权限时，你也需要以程序化方式了解它花费了你多少成本。不是在月底，而是贯穿全天、按产品维度、以程序实际可消费的形态呈现。

Billable Usage API 就是这种形态。而且客户多年来一直在向我们索要程序化用量功能。财务团队希望将支出拉取到自己的系统中，并将成本归因到内部项目、团队，甚至他们的最终客户。开发者希望有一个可以直接写进脚本的 curl 命令。这些工作流中的每一个，过去都涉及截图或手动导出。现在只需一个 HTTP 调用，或在 Vantage 中进行一次配置即可。

后续规划

更细粒度的时间窗口。目前 API 返回的是计费周期行，对大多数产品来说就是按天。我们正在研究为合适的产品提供更实时的细分数据。

预测。CumulatedContractedCost 告诉你当前计费周期内的支出情况。我们希望帮助你预测最终会达到什么水平。而且不仅限于账户级别，还包括产品级别。

企业版覆盖。本次首发仅面向自助服务账户。面向企业合同的同等体验正在开发中。

立即试用

该接口现已对所有自助服务账户开放。获取一个具有 Billing Read 权限的 API token，将你的 curl 命令指向它，就能按产品维度获取当前计费周期的数据。完整参考文档可在 Cloudflare API 文档中查看。若想将其与你其余云支出并列查看，请在 Vantage 控制台中连接你的 Cloudflare 账户。

Cloudflare 多年来一直致力于让你更轻松地在我们的网络上运行更多技术栈。现在是时候让我们同样轻松地让你看到这需要花费多少成本——无论是在 Cloudflare 上，还是在其他任何地方。