推出可计费用量API：Cloudflare的程序化成本可见性
内容提要
Cloudflare推出新的可计费用量API，供自助服务账户通过单一端点按产品和服务周期查询用量与成本，覆盖Workers、R2等产品，字段与FOCUS规范对齐。该API支持自动化成本监控，并与Vantage合作集成，实现跨云提供商的成本分配、异常检测和FinOps代理查询。未来将提供更细粒度时间窗口、预测功能和企业版支持。
延伸解读
API设计对齐FOCUS规范的意义
该API的字段命名刻意与FOCUS（FinOps开放成本与用量规范）对齐，如BillingCurrency、ServiceName、ContractedCost等。这意味着使用FOCUS格式数据的成本管理工具可以直接识别Cloudflare的用量数据，无需额外转换。虽然目前尚未完全符合FOCUS规范，但这一设计降低了多云环境下的成本数据整合难度，为后续实现跨云成本统一视图打下基础。
对自动化成本监控的实用价值
该API允许开发者通过单一HTTP请求获取账户内所有按用量计费产品的成本数据，支持按服务周期查询。这使成本监控可以完全自动化，例如通过脚本定期拉取数据并触发告警。对于使用代理或自动化工具管理基础设施的团队，这种程序化访问比依赖仪表盘更高效，能及时捕捉成本异常，避免月底账单超支。
与Vantage集成带来的跨云成本管理能力
通过与Vantage的合作，Cloudflare用户可以将用量数据纳入统一的成本管理平台，实现跨AWS、Azure等提供商的成本分配和异常检测。Vantage支持通过虚拟标签按团队或产品线分配成本，并可通过Slack或邮件发送告警。此外，其FinOps代理支持自然语言查询，如询问“上周最大成本驱动因素”，使成本分析更直观。
当前限制与未来展望
目前该API仅适用于自助服务账户，企业版支持仍在开发中。数据更新频率为每日，而非实时，且尚未提供预测功能。对于需要实时监控或预测性成本管理的用户，这些限制可能影响使用体验。不过，Cloudflare已计划提供更细粒度的时间窗口和预测功能，未来有望增强其成本可见性能力。
Q&A
Cloudflare 新推出的可计费用量 API 是什么？
Cloudflare 新推出的可计费用量 API 是一个单一端点，允许自助服务账户通过一次调用获取账户的用量和成本数据，按产品和服务周期细分，覆盖 Workers、R2、D1、Workers AI、Vectorize、Images 和 Stream 等所有按用量计费的产品。
如何使用 Cloudflare 可计费用量 API？
使用 API 需要获取具有 Billing Read 权限的 API 令牌，然后向端点 https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/billable-usage 发送 GET 请求，可添加 from 和 to 参数指定时间范围。响应为 JSON 格式，包含每个产品每个计费周期的用量和成本数据。
Cloudflare 可计费用量 API 返回哪些字段？
返回的字段包括 ServiceName（产品名称）、ServiceFamilyName（产品系列）、ChargePeriodStart/End（计费周期）、PricingQuantity 和 ConsumedUnit（用量及单位）、ContractedCost（成本）、CumulatedPricingQuantity 和 CumulatedContractedCost（累计值）、ZoneId/ZoneName（区域信息）等。
Cloudflare 可计费用量 API 与 FOCUS 规范有什么关系？
API 的字段命名与 FOCUS（FinOps Open Cost and Usage Specification）规范对齐，例如 BillingCurrency、ChargePeriodStart/End、ServiceName、ConsumedQuantity、PricingQuantity、ContractedCost 等字段与 FOCUS 列名完全匹配。但 Cloudflare 尚未完全符合 FOCUS 规范，部分必需列尚未包含，完整符合规范在路线图中。
Cloudflare 与 Vantage 的合作提供了哪些功能？
Cloudflare 与 Vantage 合作，提供原生集成，用户可以将 Cloudflare 账户连接到 Vantage，实现跨云提供商的成本分配、异常检测和 FinOps 代理查询。具体功能包括：通过虚拟标签按团队或产品线分配成本；通过成本警报监控异常支出；通过 FinOps 代理或 MCP 服务器查询成本数据。
Cloudflare 可计费用量 API 的未来计划是什么？
未来计划包括：提供更细粒度的时间窗口（目前为每日更新，未来可能提供更实时数据）；增加预测功能，帮助用户预测当前计费周期的最终成本；以及为企业合同提供等效的 API 支持（目前仅限自助服务账户）。
