はじめに

このガイドでは、最初の AI Gateway の設定と使い方を説明します。

リクエストを送る前に、次の 2 つが必要です。

1. Account ID — Cloudflare ダッシュボード で確認します。
2. Cloudflare API トークン — AI Gateway - Read、AI Gateway - Edit、Workers AI - Read の権限で API トークンを作成 します。

次のコマンドを実行し、AI Gateway 経由で最初のリクエストを送ります。この例は Workers AI モデルを呼び出します。@cf/ のモデルプレフィックスと cf-aig-gateway-id ヘッダーが必要です。

# Run `wrangler auth token` to get an auth token to replace $CLOUDFLARE_API_TOKEN,
# and `wrangler whoami` to replace $CLOUDFLARE_ACCOUNT_ID.
curl -X POST "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/v1/chat/completions" \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "cf-aig-gateway-id: default" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "@cf/moonshotai/kimi-k2.6",
    "messages": [
      {
        "role": "user",
        "content": "What is Cloudflare?"
      }
    ]
  }'

cf-aig-gateway-id: default ヘッダーは、この Workers AI リクエストをアカウントのデフォルトゲートウェイ経由でルーティングします。ゲートウェイが存在しない場合、AI Gateway は最初の認証済みリクエストで作成します。ゲートウェイ経由にすると、ログ、分析、キャッシュ、レート制限、セキュリティ制御を一元化できます。自動作成されたゲートウェイは、デフォルトで Standard billing を使います。プリペイドの AI Gateway クレジットで支払う場合は、Workers AI の課金設定を Unified billing に変更 します。

上流の AI プロバイダーには、次のいずれかの方法で認証します。

• Unified Billing: Workers AI と対応するサードパーティモデルプロバイダーに、プリペイドの AI Gateway クレジットを使います。Unified Billing を参照してください。
• BYOK (Store Keys): 独自のプロバイダー API キーを Cloudflare に保存すると、AI Gateway が実行時に付与します。BYOK を参照してください。
• リクエストヘッダー: 通常どおり、リクエストヘッダーにプロバイダー API キーを含めます（例: Authorization: Bearer <OPENAI_API_KEY>）。

Cloudflare 上かサードパーティプロバイダーかを問わず、同じ Cloudflare API で任意のモデルを呼び出せます。プロバイダー SDK や API キーは不要です。認証と課金は Cloudflare アカウントで処理します。エンドポイントは 3 つあります。すべてのモダリティ向けの /ai/run、OpenAI SDK 互換の /ai/v1/chat/completions、エージェントワークフロー向けの /ai/v1/responses です。

# 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 を参照してください。

特定の AI プロバイダーと直接連携する場合は、元のプロバイダーの API スキーマを維持しつつ AI Gateway の機能を追加する専用エンドポイントを使います。

https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/{provider}

利用可能なプロバイダー:

• OpenAI - GPT モデルと埋め込み
• Anthropic - Claude モデル
• Google AI Studio - Gemini モデル
• Workers AI - Cloudflare の推論プラットフォーム
• AWS Bedrock - Amazon のマネージド AI サービス
• Azure OpenAI - Microsoft の OpenAI サービス
• その他...

• リクエストの高速化とコスト削減のための キャッシュ、アプリケーションのスケールを制御する レート制限 について学びます。
• 耐障害性のためのモデルまたはプロバイダーの フォールバック、レート制限、A/B テスト の指定方法を確認します。
• Cloudflare の AI 推論サービス Workers AI で、低コストのオープンソースモデルを使う方法を学びます。