Cloudflareの課金使用量API：エージェント向けのプログラムによるコスト可視化

CloudflareのAgents Weekは、エージェントがコードを書き、Workersをデプロイし、インフラをプロビジョニングするというシフトに焦点を当てて始まりました。そのシフトには新たな種類の可視性が求められます。プログラムがあなたのアカウントでお金を使っているなら、その支出を1日を通して、製品ごとに、別のプログラムが消費できる形で把握する必要があります。ダッシュボードは人間向けです。課金使用量APIは自動化向けです。

セルフサービスアカウントで利用可能な新しいエンドポイントは、製品とサービス期間ごとに使用量とコストを返します。1回の呼び出しで、Workers、R2、D1、Workers AI、Vectorize、Images、Streamなど、すべての使用量ベースの製品をカバーします。レスポンスは標準のCloudflare APIエンベロープを使用し、各行が製品の請求期間を表します。

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"

各行には、ServiceName、ServiceFamilyName、ChargePeriodStart/ChargePeriodEnd、PricingQuantity、ConsumedUnit、ContractedCost、および累計合計などのフィールドが含まれます。ほとんどはFinOps Open Cost and Usage Specification（FOCUS）に直接マッピングされ、既存のFinOpsツールチェーンとの統合が容易です。

Cloudflareはまだ完全なFOCUS準拠を主張していません。いくつかの必須列が欠けていますが、それはロードマップにあります。これは最初のステップです。今は馴染みのある形、次は完全準拠です。

APIに加えて、Cloudflareはコスト管理プラットフォームであるVantageと提携し、ネイティブ統合を提供しています。Vantageは30以上のプロバイダーからデータを取り込み、この統合により、Cloudflareの支出が同じコストレポート、予算、コストアラートに表示されます。支出を製品、ゾーン、アカウントごとに割り当て、Slackやメールで異常を検出し、FinOpsエージェントやMCPサーバーを介してデータをクエリすることもできます。

なぜこれを構築するのか？エージェントはコードを書くだけでなく、Workersをデプロイし、R2バケットをプロビジョニングし、D1データベースを管理します。プログラムによるアクセスを許可する場合、プログラムによる可視性が必要です。財務チームは支出を内部システムに取り込みたいと考え、開発者はスクリプト化できるcurlを望んでいます。このAPIはそれをHTTP呼び出しに変えます。

次のステップ：より細かい時間枠（よりリアルタイムなデータ）、累計コストに基づく予測、およびエンタープライズ契約のカバレッジ。今のところ、セルフサービスアカウントはBilling Readトークンを使用してすぐにエンドポイントを使い始めることができます。