可计费使用 API：Cloudflare 的编程成本可见性

代理周是关于已经正在进行的转变：代理代表您编写代码、部署工作人员并配置基础设施。这种转变会改变您需要看到的内容。如果某个程序在您的 Cloudflare 账户中花钱，您需要知道它花了什么；全天，每种产品以另一个程序可以消耗的形式。仪表板是人类的正确答案。这不是自动化的正确答案。因此，我们为自助帐户推出了一个新的可计费使用 API：一个返回您帐户的使用情况和费用（按产品和服务期限细分）的单一端点。它涵盖了账户上所有基于使用情况的 Cloudflare 产品，包括 Workers、R2、D1、Workers AI、Vectorize、Images 和 Stream，所有这些产品只需一次调用即可。如果您已经使用 FinOps 工具链，那么列名称应该看起来很熟悉。卷曲 https ：//api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/billable-usage \ - H“授权：持有者 $CLOUDFLARE_API_TOKEN” 卷曲“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 开放成本和使用规范 (FOCUS) 中的列，因此，如果您的团队已经从其他提供商获取 FOCUS 数据，则名称和语义应该很熟悉： Cloudflare 字段 FOCUS 列 注释 BillingCurrency BillingCurrency 完全匹配。 BillingPeriodStart BillingPeriodStart 完全匹配。 ChargePeriodStart / ChargePeriodEnd ChargePeriodStart / ChargePeriodEnd 完全匹配。服务名称 服务名称 完全匹配。 ConsumedQuantity / ConsumedUnit ConsumedQuantity / ConsumedUnit 完全匹配。 PricingQuantity PricingQuantity 完全匹配。 ContractedCost ContractedCost 完全匹配。 ServiceFamilyName（接近 ServiceCategory ）Cloudflare 原生分组； FOCUS 使用受控词汇。 CumulatedContractedCost（派生） 便利字段 — FOCUS 将累积视为查询问题。 ZoneId / ZoneName （接近 ResourceId / ResourceName ）区域范围标识符（如果适用）。响应使用标准 Cloudflare API 信封 - 结果是一组行，每个充电周期每个产品一个，以及 success 、errors 和 messages 。 { “结果” : [ { “BillingCurrency” : “美元” , “BillingPeriodStart” : “2025-02-01T00:00:00Z” , “ChargePeriodStart” : “2025-02-01T00:00:00Z” , “ChargePeriodEnd” : "2025-02-28T23:59:59Z"、"ServiceName"："工人标准"、"ServiceFamilyName"："工人"、"ConsumedQuantity"：150000、"ConsumedUnit"："GB 月"、"ContractedCost"：0.75、"CumulatedContractedCost"： 2.25 } ], "success" : true , "errors" : [], "messages" : [] } 我们在 FOCUS 上的位置 匹配 FOCUS 命名是经过深思熟虑的选择。 AWS、Azure、Google Cloud、Oracle 和越来越多的 SaaS 提供商已经发布了 FOCUS 格式的导出，并且每个重要的成本管理工具都可以使用它。也就是说，我们尚未声称完全符合：规范要求的少数列不在今天的有效负载中。实现这一目标已在我们的路线图上。将此视为第一步：现在熟悉形状，下一步完全一致。 Cloudflare 支出，以及您的其他云支出：我们与 Vantage 的合作伙伴关系 我们与 Vantage 就原生 Cloudflare 集成进行了合作。 Vantage 是一个基础设施成本管理平台，可从 AI、云和 SaaS 提供商的 30 多家提供商处获取成本和使用数据，并将其纳入单一视图中以进行报告、分配和优化。通过这种集成，您的使用情况将流入您已用于基础设施其余部分的相同成本报告、预算和成本警报中。 Vantage 使用具有计费读取访问权限的只读 API 令牌连接到 Cloudflare。连接后，Vantage 每天都会提取您的计费使用数据，并按产品（例如 Workers 和 R2）、区域和帐户进行细分，以便您可以查看哪些产品推动了您的支出，并将其归因于其背后的团队和服务。此集成支持的一些工作流程： 跨提供商分配。按产品、区域和帐户对 Cloudflare 支出进行分组，然后使用虚拟标签按团队或