OpenAICloudflare Developer Platform2026/05/21 0:00

AI Gateway - Call any AI model through AI Gateway's new REST API

要点だけを先に読めるように短く再構成したセクションです。

元記事

OpenAI Claude

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

openaijamodel: gpt-5-mini-2025-08-07

AI Gateway：新REST APIで任意のAIモデルを統一呼び出し

ai-gateway rest-api workers-ai unified-billing rate-limiting model-routing

Key Points

統一APIで全モデル呼出
自動的にログ・キャッシュ適用
cf-aig-gateway-idでゲート指定

Summary

AI Gatewayはapi.cloudflare.com上の新しいAI REST APIを公開しました。OpenAI、Anthropic、Google、Workers AIなど任意のモデルを同一のエンドポイントと認証で呼び出せます。全てのリクエストに対してログ、キャッシュ、レート制御、ガードレールが自動適用され、サードパーティモデルはUnified Billingで請求されます。

利用可能な主要エンドポイント:

POST /ai/run — 全モデル・全モダリティ向けの汎用エンドポイント
POST /ai/v1/chat/completions — OpenAI SDK互換
POST /ai/v1/responses — OpenAI Responses API互換
POST /ai/v1/messages — Anthropic SDK互換

既存のWorkers AI向けの古いパス（/ai/run/@cf/{model}）は引き続き利用可能です。AI Gateway経由でWorkers AIを呼ぶ場合はモデル名に @cf/ プレフィックスを付け、特定ゲートウェイを使うには cf-aig-gateway-id ヘッダーを指定します。

簡単なcurl例:

curl -X POST "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/v1/chat/completions" \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/gpt-5.5","messages":[{"role":"user","content":"What is Cloudflare?"}]}'

Key Points

単一のREST APIで複数プロバイダ（OpenAI/Anthropic/Google/Workers AI）を呼び出し可能
OpenAI/Responses/Anthropic互換の専用エンドポイントを提供
ログ・キャッシュ・レート制限・ガードレールが自動適用
サードパーティモデルはUnified Billingで請求、別プロバイダAPIキー不要
デフォルトゲートウェイは初回利用時に自動作成。特定ゲートウェイは cf-aig-gateway-id で指定
既存の /ai/run/@cf/{model} パスは継続サポート

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

openaijamodel: gpt-5-mini-2025-08-07

AI Gateway — 新しいREST APIで任意のAIモデルを呼び出す

公開日: 2026-05-21

AI Gatewayは現在 api.cloudflare.com のAI REST APIを使用しています。OpenAI、Anthropic、Google、または Workers AI でホストされているモデルでも、プロバイダに関係なく、同じエンドポイントと認証を使って単一のAPI経由で呼び出せます。

利用可能なエンドポイントは4つです:

POST /ai/run — すべてのモデルとモダリティに対する汎用エンドポイント
POST /ai/v1/chat/completions — OpenAI SDK 互換
POST /ai/v1/responses — OpenAI Responses API 互換
POST /ai/v1/messages — Anthropic SDK 互換

例（curl）:

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-5.5", "messages": [{"role": "user", "content": "What is Cloudflare?"}] }'

すべてのAI Gatewayの機能（ログ記録(logging)、キャッシュ(caching)、レート制限(rate limiting)、ガードレール(guardrails)）は自動的に適用されます。サードパーティのモデルは Unified Billing によって請求されるため、プロバイダごとのAPIキーを別途管理する必要はありません。

サードパーティモデルのリクエストは、最初の使用時に自動的に作成されるアカウントのデフォルトゲートウェイ経由でルーティングされます。特定のゲートウェイを経由させるには、cf-aig-gateway-id ヘッダーを追加してください。

既に Workers AI モデルを既存のREST API経由（/ai/run/@cf/{model}）で呼び出している場合、そのパスは引き続き動作します。AI Gateway 経由で Workers AI モデルを呼び出すには、モデルプレフィックスに @cf/ を使用（例: @cf/moonshotai/kimi-k2.6）し、どのゲートウェイを通すかを指定するために cf-aig-gateway-id ヘッダーを含めてください。

詳細と例は REST APIドキュメントを参照してください（https://api.cloudflare.com）。