Unified Billing

Unified Billing では、Workers AI を呼び出し、さまざまな AI プロバイダー（OpenAI、Anthropic、Google AI Studio など）に接続して、Cloudflare の請求書 1 枚で支払いできます。Unified Billing を使うには、Cloudflare dashboard でクレジットを購入して Cloudflare アカウントにチャージし、それを AI Gateway で使います。

Unified Billing 経由で購入したクレジットには 5% の手数料がかかります。たとえば、100 ドル分のクレジット購入では 105 ドルが請求されます。プロバイダーの推論料金は上乗せなしでそのまま適用されます。プロバイダーへ直接支払う場合と同じトークン単価です。

• Cloudflare アカウントに 十分なクレジットがチャージされている ことを確認します。
• AI Gateway を 認証 済みであることを確認します。
• Workers AI でクレジットを使うには、ゲートウェイの Workers AI Billing 設定を Unified billing にします。

AI Gateway 用のクレジットをチャージするには:

1. Cloudflare dashboard で AI Gateway ページを開きます。

   AI Gateway を開く ↗

   右上の Credits Available カードに、アカウント上の現在の AI Gateway クレジット数が表示されます。

2. Credits Available で Manage を選択します。

3. アカウントに利用可能な支払い方法がない場合、AI Gateway はクレジット購入のために支払い方法の追加を求めます。支払い方法を追加します。

4. Top-up credits を選択します。

5. 購入するクレジット額を追加し、Confirm and pay を選択します。

残高が一定のしきい値を下回ったときに、AI Gateway がクレジットを自動補充するよう設定できます。自動チャージを設定するには:

1. Cloudflare dashboard で AI Gateway ページを開きます。

   AI Gateway を開く ↗

2. Credits Available で Manage を選択します。

3. Setup auto top-up credits を選択します。

4. 自動チャージのしきい値と補充額を選びます。

残高が設定したしきい値を下回ると、AI Gateway は自動チャージ額をアカウントに適用します。

リクエストが AI Gateway に到達すると、資格情報は次の順で解決されます。

1. リクエスト上のプロバイダーキー — リクエストがプロバイダー認証（Authorization ヘッダーなど）を持つ場合、AI Gateway はそれを変更せずプロバイダーへ転送します。BYOK と Unified Billing は参照されません。
2. BYOK（保存済みキー） — リクエストにプロバイダーキーがなく、ゲートウェイが default エイリアスでそのプロバイダーの 保存済みキー を持つ場合、そのキーが使われます。
3. Unified Billing — 上記のいずれにも当てはまらない場合、リクエストは Cloudflare 管理の資格情報で処理され、Cloudflare のクレジット残高に対して課金されます。

Require provider credentials をオンにすると、サードパーティプロバイダーの Unified Billing フォールバックを防げます。サードパーティプロバイダーのリクエストは、リクエストと一緒に渡すかゲートウェイに保存した資格情報を使う必要があります。適用できる資格情報がないリクエストは、Cloudflare 管理の資格情報を使わず、HTTP 400 応答を返します。

1 件のサードパーティプロバイダーリクエストでプロバイダー資格情報を必須にするには、cf-aig-no-wholesale ヘッダーを true に設定します。このヘッダーは Unified Billing フォールバックを防げますが、ゲートウェイ設定を緩めることはできません。Require provider credentials がオンの場合、ヘッダーを false にしても効果はありません。

Workers AI のリクエストはプロバイダー資格情報を使いません。この設定はこれらのリクエストをブロックせず、ゲートウェイの Workers AI 課金モードも変更しません。

Unified Billing の使い方は 2 つです。AI バインディング経由と HTTP API 経由です。どちらもプロバイダー API キーなしで、アカウントからクレジットを自動控除します。

Workers AI でクレジットを使うには、ゲートウェイの Workers AI 課金設定 を Unified billing にします。そのゲートウェイ経由の Workers AI リクエストは、プリペイドクレジット残高からリアルタイムで控除されます。AI バインディングでは、env.AI.run() の第 3 引数にゲートウェイ ID を含めます。REST API リクエストでは、cf-aig-gateway-id ヘッダーを含めます。プリペイドクレジットは、通常は Workers Paid プランが必要な Workers AI モデルへのアクセスを提供し、フロンティアモデルのより高いレート制限 も提供します。

モデルカタログ に掲載された任意のモデルを env.AI.run() で呼び出します。Workers AI モデルと、OpenAI、Anthropic、Google などのサードパーティモデルの両方を含みます。

const resp = await env.AI.run(
	"openai/gpt-4.1-mini",
	{
		messages: [{ role: "user", content: "What is Cloudflare?" }],
	},
	{
		gateway: { id: "my-gateway" },
	},
);

完全な API 面は バインディングリファレンス を参照してください。

プロバイダー API キーを渡さずに、AI Gateway REST API 経由でサポート対象のプロバイダーを呼び出します。

Cloudflare API でサードパーティモデルを呼び出します。Authorization ヘッダーに Cloudflare API トークンを渡します。

# Run `wrangler whoami` to get your account ID to replace $CLOUDFLARE_ACCOUNT_ID,
# and `wrangler auth token` to get an auth token to replace $CLOUDFLARE_API_TOKEN.
curl -X POST "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/v1/chat/completions" \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "openai/gpt-4.1-mini",
    "messages": [{"role": "user", "content": "What is Cloudflare?"}]
  }'

利用できるすべてのエンドポイントの詳細は REST API を参照してください。

プロバイダーネイティブエンドポイント 経由でプロバイダーを直接呼び出すこともできます。認証には cf-aig-authorization ヘッダーを使います。

HTTP API は次のプロバイダーをサポートします。

• OpenAI
• Anthropic
• Google AI Studio
• Google Vertex AI
• xAI
• Groq

個別ゲートウェイに 支出上限ルール を設定し、モデル、プロバイダー、ユーザーやチームなどのカスタムメタデータ次元で支出を上限できます。

Zero Data Retention (ZDR) は、プロンプトや応答を保持しないプロバイダーエンドポイント経由で Unified Billing トラフィックをルーティングします。ゲートウェイレベルの zdr 設定で有効にします。この設定は ZDR 対応のアップストリームプロバイダー構成に対応します。この設定は、Cloudflare 管理の資格情報を使う Unified Billing リクエストにのみ適用されます。BYOK やその他の AI Gateway リクエストには適用されません。

ZDR は AI Gateway のログ記録を制御しません。AI Gateway でリクエスト / 応答ログを無効にするには、Logging でログ設定を別に更新します。

ZDR は現在、次でサポートされます。

• OpenAI
• Anthropic

ZDR 非対応のプロバイダーで ZDR を有効にすると、AI Gateway は標準（非 ZDR）の Unified Billing 構成へフォールバックします。

cf-aig-zdr ヘッダーで、1 件の Unified Billing リクエストについてゲートウェイのデフォルトを上書きします。ZDR を強制するには true、そのリクエストで ZDR を無効にするには false にします。

# Run `wrangler whoami` to get your account ID to replace $CLOUDFLARE_ACCOUNT_ID,
# and `wrangler auth token` to get an auth token to replace $CLOUDFLARE_API_TOKEN.
curl -X POST "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/v1/chat/completions" \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --header "cf-aig-zdr: true" \
  --data '{
    "model": "openai/gpt-4.1-mini",
    "messages": [
      {
        "role": "user",
        "content": "Explain Zero Data Retention."
      }
    ]
  }'