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

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

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

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/billable-usage \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/billable-usage?from=2026-02-01&to=2026-02-15" \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

你将收到 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 字段。

{
  "result": [
    {
      "BillingCurrency": "USD",
      "BillingPeriodStart": "2025-02-01T00:00:00Z",
      "ChargePeriodStart": "2025-02-01T00:00:00Z",
      "ChargePeriodEnd": "2025-02-28T23:59:59Z",
      "ServiceName": "Workers Standard",
      "ServiceFamilyName": "Workers",
      "ConsumedQuantity": 150000,
      "ConsumedUnit": "GB-months",
      "ContractedCost": 0.75,
      "CumulatedContractedCost": 2.25
    }
  ],
  "success": true,
  "errors": [],
  "messages": []
}

我们在 FOCUS 合规方面的进展

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

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

我们与 Vantage 合作推出了原生 Cloudflare 集成。Vantage 是一个基础设施成本管理平台，可接入来自 30 多家提供商（涵盖 AI、云和 SaaS 提供商）的成本与用量数据，并将其整合到单一视图中，用于报告、分摊和优化。借助这一集成，您的用量会流入您已在用于其余基础设施的同一套成本报告、预算和成本告警中。

Vantage 通过一个具有 Billing Read 权限的只读 API token 连接到 Cloudflare。连接后，Vantage 每天拉取您的可计费用量数据，并按产品（如 Workers 和 R2）、区域和账户进行拆分，让您能够看清哪些产品在驱动支出，并将其归因到背后的团队和服务。

该集成支持的部分工作流：

• 跨提供商分摊。按产品、区域和账户对 Cloudflare 支出进行分组，然后使用虚拟标签按团队或产品线进行分摊，与您的 AWS、Azure 及其他提供商的成本并列呈现在同一份报告中。
• 异常检测。Vantage 成本警报会监控所有已连接的云服务商，并在支出偏离基线时通过 Slack 或电子邮件通知您，因此 Workers 或 R2 的费用变化会以与其他云服务商相同的方式呈现。
• FinOps 智能体与 MCP。您可以在控制台内向 Vantage FinOps 智能体提问，例如“上周我们所有云服务商中最大的成本驱动因素是什么？”，或者通过 Vantage 托管的 MCP 服务器向 Claude 或 ChatGPT 查询相同的数据。Cloudflare 的支出会与您连接的其他云服务商数据一同展示。

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

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

我们为什么构建这个功能

智能体不仅仅编写代码。它们还会部署 Workers、配置 R2 存储桶、管理 D1 数据库。当您授予对 Cloudflare 账户的程序化访问权限时，您也需要以程序化方式了解其成本。不是在月底，而是在一天之中随时，按产品维度，以程序能够实际消费的格式呈现。

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

后续规划

• 更细粒度的时间窗口。目前该 API 返回计费周期行，对大多数产品而言是每日粒度。我们正在研究为合适的产品提供更实时的细分数据。
• 预测。累计合同成本（CumulatedContractedCost）可以告诉您当前计费周期内的支出情况。我们希望帮助您预测最终的成本走向。而且不仅限于账户级别，还包括产品级别。
• 企业版覆盖。本次首发仅支持自助服务。面向企业合同的同等体验正在开发中。

立即试用

该端点今日已对所有自助服务账户上线。获取一个具有 Billing Read 权限的 API token，将你的 curl 指向该端点，即可获取按产品细分的当前计费周期数据。完整参考文档见 Cloudflare API 文档。如需将其与你的其他云支出并列查看，可在 Vantage 控制台中连接你的 Cloudflare 账户。

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