Japanese Translation:

Cloudflare はセルフサーブアカウント向けに新しい Billable Usage API を公開します。この API により、単一のエンドポイントで Workers、R2、D1、Workers AI、Vectorize、Images、Stream の各製品および時間範囲ごとの利用状況と費用について即時のプログラム管理による可視性を提供します。現在データは毎日更新されていますが、今後のアップデートではより細かいタイムウィンドウと予測機能もサポートされます。レスポンスは Cloudflare の標準 API エンベロープ内で FOCUS 標準に従い、BillingCurrency、ChargePeriodStart/End、PricingQuantity、CumulatedContractedCost などのフィールドを含みます。これは Vantage を基に構築されたものであり、すでに 30 以上のプロバイダーでネイティブな成本管理統合を提供し、リードアオンリートークンを使用して製品、ゾーン、アカウントごとの日次請求可能利用状況を取得しています。ユーザーは現在、Virtual Tags を使用したクロスプロバイダー配分、Slack またはメールアラートによる異常検出、FinOps エージェント/LLM クエリ（例：Claude や ChatGPT で）を含む高度なワークフローを有効にできます。この API は今日セルフサーブアカウント向けにライブです。Enterprise コントラクト向けの同様の体験は開発中です。

Cloudflare「Billable Usage API」と FinOps 統合発表：エージェント時代の成本管理への対応

背景と目的

AI エージェントはコードの記述だけでなく、ワーカーのデプロイやインフラストラクチャの用意も実行できるようになります。これにより、以下のようなコスト管理の変化が必要です。

可視性の必要性: プログラムが Cloudflare アカウントを使用している場合、その内訳を**リアルタイム（一日中）**で把握する必要があります。
人間向けダッシュボードの限界: 従来の人間向けのダッシュボードでは不十分であり、自動化されたシステムへの対応が求められています。

この課題に対応するため、新しい**「Billable Usage API（課金可能な使用量 API）」**をセルフサービスアカウント向けに公開します。

Billable Usage API の概要

エンドポイントの機能

単一のエンドポイント: すべての使用量ベースの製品を一括で取得可能です。
- ワーカー (Workers)
- R2
- D1
- ワーカー AI
- Vectorize
- Images
- Stream
返却データ: 製品ごとおよび課金期間ごとの使用量とコストを返します。
更新頻度: 現在は毎日更新。よりリアルタイムなデータ提供のため開発中です。

リクエスト例 (curl)

基本的な使用量の取得：

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
```
コンテンツタイプ:
```
application/json
```
構造: 標準的な Cloudflare API エンベロープを使用し、
```
result
```
フィールドに製品ごとのデータ配列を含みます。

レスポンスサンプル

{
  "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（FinOps Open Cost and Usage Specification）準拠

API は FOCUS 命名法 と整合性を持たせて設計されています。これにより、AWS、Azure、Google Cloud、Oracle などの他クラウドプロバイダーや SaaS ツールとの連携が容易になります。

対応フィールド一覧

多くの項目は FOCUS 仕様の列と直接対応しています。

Cloudflare フィールド	FOCUS 列	備考
`BillingCurrency`	`BillingCurrency`	完全一致
`BillingPeriodStart`	`BillingPeriodStart`	完全一致
`ChargePeriodStart / ChargePeriodEnd`	`ChargePeriodStart / ChargePeriodEnd`	完全一致
`ServiceName`	`ServiceName`	完全一致
`ConsumedQuantity / ConsumedUnit`	`ConsumedQuantity / ConsumedUnit`	完全一致
`PricingQuantity`	`PricingQuantity`	完全一致
`ContractedCost`	`ContractedCost`	完全一致
`ServiceFamilyName`	（ServiceCategory に近い）	Cloudflare 固有のグループ化；FOCUS は管理された語彙を使用
`CumulatedContractedCost`	（派生列）	利便性向上のためのフィールド；FOCUS では累積は通常クエリ対象とみなされる
`ZoneId / ZoneName`	（ResourceId / ResourceName に近い）	ゾーンスコープの適用がある場合のみ表示

注: 仕様で要求されている少数の列は今後ロードマップに記載された計画で追加予定であり、現在「完全な準拠」とは謳っていません。第一歩として慣れ親しんだ構造を提供します。

Vantage との統合によるクロスプロバイダー管理

Cloudflare とのコラボレーションにより、インフラストラクチャコスト管理プラットフォームである Vantage への統合が開発されました。

主な連携機能

接続方法: Vantage は「Billing Read」アクセスを持つ読み取り専用 API トークンを使用して Cloudflare に接続します。
データ収集: 毎日抽出したデータを製品、ゾーン、アカウントごとに分解し、他インフラと同等のビューで統合します。

サポートされるワークフロー

クロスプロバイダー配分
- Cloudflare のコストを AWS や Azure など他のプロバイダのコストと並行して比較可能。
- 仮想タグを使用して、チームや製品ラインごとに統一レポート内で配分する。
異常検知
- Vantage Cost Alerts で全ての接続プロバイダーを監視。
- 支出が基準から逸脱した際、Slack または E メールで通知を発行（ワーカーや R2 の変化も同様に検知）。
FinOps エージェントと MCP
- Vantage FinOps エージェントへの自然言語クエリ（例：「昨週の最大のコストドライバーは何でしたか？」）。
- MCP サーバーを介して Claude や ChatGPT から直接データを取得可能。
- Cloudflare の支出は他プロバイダと並んで表示される。

これにより、手動のエクスポートや個別のダッシュボード維持が不要になり、コストは実行中のすべてのインフラストラクチャの横に表示されます。

この API を構築した理由

AI エージェント時代の成本管理には、以下のニーズがあります。

プログラムの自律性: エージェントはワーカーをデプロイし、R2 バケットをプロビジョニングします。そのアカウントがどの程度のコストを生んでいるかをプログラムによる可視性が必須です。
リアルタイム監視: 月末のまとめではなく、一日中を通じて製品ごとの消費状況を知る必要があります。
財務チームとの連携: 支出を内部プロジェクトやチームへ配属する独自のシステムへの統合ニーズがあります。
開発者の利便性: スクリプトにドロップできる
```
curl
```
コマンドなどの HTTP クールによる取得が求められています。

次のステップとロードマップ

今後の機能強化予定

より細かい時間窓: 現在日次ですが、製品によってはよりリアルタイムな分解表示への対応を検討中。
予測分析:
```
CumulatedContractedCost
```
の利用に加え、支出の最終地点を予期するためのアカウント・製品レベルの予測機能を実装。
エンタープライズ対応: 現在セルフサービス向けですが、エンタープライズ契約向けの同等な体験実現に向けて進行中。

試してみる

Cloudflare ダッシュボードで**「Billing Read」権限を持つ API トークン**を取得してください。
上記の
```
curl
```
コマンドを実行し、現在の課金期間データを入手してください。
他クラウド支出との比較には、Vantage コンソールで Cloudflare アカウントを接続するか、公式ドキュメントの完全なリファレンスを参照してください。

Cloudflare はネットワーク運用の容易化に尽力してきたが、今こそその費用を世界中のどこでも同等に見やすくする取り組みが必要です。

Billable Usage API：Cloudflare のプログラムによるコスト可視化