・AIの呼び出しの量と費用を見たい
・使いすぎを回数や金額で止めたい
・APIキーと支払いの置き場所に迷っている
Cloudflare AI Gateway は、アプリから AI の提供元(Workers AI・OpenAI・Anthropic など)への呼び出しを、途中で受けて中継する入り口です。通すと、使った量と費用の記録、完全に同じ要求への答えの使い回し、回数や金額による停止ができます。このうち分析・キャッシュ・レート制限には、どのプランでも料金がかかりません。
この記事では、つなぎ方、できること、キーと支払い、料金とログ、始め方と注意点を、2026年11月時点の公式ドキュメントで整理します。
この記事のゴール(読了目安 約8分)
AI Gatewayのつなぎ方と無料の範囲を知り、自分のアプリで使うか判断できるようになる
Cloudflare AI Gatewayとは
AI Gateway は、アプリと、アプリが呼ぶ AI の API の間に立つ中継点(プロキシ)です。公式は、AI のアプリを見えるようにし、制御するサービスと位置づけています。
- 見えるようにする:分析・ログ
- 制御する:キャッシュやレート制限、失敗時の再試行、モデルの切り替えなど
AI Gateway はモデルを動かさず、アプリと提供元の間で呼び出しを中継して管理します。 モデルを Cloudflare の GPU で動かすのは Workers AI の役目です。2026年8月からは、Workers AI のモデルも外部の提供元のモデルも、同じ AI バインディング(Worker のコードから機能を呼ぶつなぎ)と REST API で呼べます。その記録や請求の管理は AI Gateway が受け持ちます。モデルの動かし方とエージェントの作り方はWorkers AIとAgents SDKの記事で解説しています。
AI Search のインスタンスもゲートウェイにつながり、回答の生成などがそこを通ります。資料を取り込んで答える仕組みはCloudflare AI Searchとはにまとめています。
AI Gatewayの仕組みと3つのつなぎ方
呼び出しの宛先を AI Gateway に向けると、ゲートウェイが上限やキャッシュを確かめてから提供元へ送り、答えを記録してアプリに返します。宛先の向け方は3つあります。
REST API には OpenAI や Anthropic の SDK と互換の窓口があり、提供元のキーなしで外部のモデルも呼べます。提供元別の窓口は、提供元の書き方のまま宛先の URL を替えて使います。新しく組むなら REST API、今のコードを活かすなら提供元別の窓口を選びます。

ゲートウェイは先に作らなくても構いません。ID を省くか default にすると、最初の認証済みの呼び出しで自動で作られます。認証は初めからオンです。アプリや用途ごとに分けるなら、名前を付けて作ります。
できること:記録・節約・制限
機能は「記録」「節約」「制限」と、安全のための検査に分かれます。

- 費用は、送受信したトークンの数からの見積もりです。正確な金額は提供元の画面で確かめます
- キャッシュは既定では、提供元の認証ヘッダーまで含めて要求全体が一致したときだけ当たります。自由入力の質問では当たりにくく、選択肢の限られたサポートのボットに向きます
- レート制限は、そのゲートウェイへの呼び出しすべてに同じ値でかかります
レート制限は回数、支出上限は金額で呼び出しを止めます。 ここで扱うレート制限は、AI の呼び出し回数の上限です。サイトや API への要求を数える WAF のルールとは別の設定です。サイトへのアクセスを回数で止める設定は、Cloudflare Rate Limitingとはで説明しています。
APIキーの置き場所と支払い
提供元の API キーの扱いは3通りで、分かれ目は前払いのクレジットを使うかどうかです。
BYOK(自分のキーを Cloudflare に預ける方法)では、アプリから提供元の認証ヘッダーを外します。残すと、その値が提供元へ送られます。
Unified Billing は、カードで買ったクレジットから外部の AI の利用料も払う方法です。提供元のトークン単価への上乗せはありません。
キーは次の順番で選ばれます。
- リクエストに付いた提供元のキー
defaultの名前で預けたキー- どちらも無ければ、前払いのクレジット

REST API とバインディングでは、default 以外の名前で預けたキーは参照されません。キーを付け忘れた呼び出しは、前払いのクレジットから払われることがあります。 避けるには、ゲートウェイの Settings で Require provider credentials をオンにし、キーの無い外部の提供元への呼び出しを 400 で止めます。
AI Gatewayの料金とログの扱い
2026年11月時点の公式ページでは中核機能は無料で、お金がかかりうるのは AI の利用料、一部の機能、ログの保存です。
表に無い機能の料金は、料金ページに載っていません。作れるゲートウェイの数は、無料プランが10個、有料プランが20個までです。
ログの料金を分けるのは、アカウントが最初のゲートウェイを作った日付です。
- 2026年9月24日以降:Workers Logs に入り、その料金と保存期間に従います。2026年12月1日に料金の体系が Cloudflare Observability へ移り、Workers のログなどと同じ枠を使います
- それより前:Legacy Logs に入ります。Workers Free は全ゲートウェイで10万件、Workers Paid はゲートウェイごとに1,000万件までです。上限に達すると、保存が止まるか古い順に消えます
料金は変わることがあるため、AI Gateway の料金ページで最新の値を見てください。
始め方:APIトークンを作って1回呼ぶ
流れは4段で、1と2が公式の Get started の手順です。
- アカウント ID を確かめ、Cloudflare の API トークンを作ります。権限は
AI Gateway - Read・AI Gateway - Edit・Workers AI - Readです - REST API の
/ai/v1/chat/completionsで Workers AI のモデルを呼びます。API トークンはAuthorizationヘッダー、ゲートウェイはcf-aig-gateway-id: defaultで付けます - ダッシュボードの AI → AI Gateway で、分析とログに呼び出しが出たか見ます
- 必要なら Settings で Cache Responses と Rate-limiting をオンにします
REST API 用の API トークンには、Workers AI の Read の権限を必ず付けます。 無いと 401 で断られます。外部のモデルは openai/gpt-4.1-mini の形で指定し、先にクレジットを入れておきます。
今の OpenAI のコードを活かすなら、URL を提供元別の窓口に替え、API トークンは cf-aig-authorization のヘッダーに入れます。バインディングからなら、このヘッダーは不要です。呼び出しの例はGet startedにあります。
使う前の注意点
困りやすいのは、認証・API トークンの権限・ログの中身・守る範囲の4つです。
- 認証:2026年11月3日以降に作るゲートウェイは、認証を必ず使います。認証の無い既存のゲートウェイも、勝手な利用を防ぐためにオンが勧められています。一度オンにすると外せないので、先に呼び出す側が API トークンを送るようにしておきます。
- API トークンの権限:AI Gateway の権限は1つのゲートウェイに絞れず、Run の権限を持つ API トークンはどのゲートウェイにも呼び出しを送れ、預けたキーも使えます。分けたいなら、アカウントを分けるか Worker のバインディングから呼びます
- ログの中身:何も設定しなければ、プロンプトと応答の本文まで保存されます。個人情報が混ざるときは、
cf-aig-collect-log-payload: falseのヘッダーで本文を保存から外します - 守る範囲:Guardrails と DLP が見るのは、アプリと提供元の間の呼び出しです。利用者から自分のアプリに届くプロンプトを調べるのは、WAF の AI Security for Apps です
入口で調べる仕組みはCloudflare AI Security for Appsとはで紹介しています。
よくある質問
AI Gatewayを通すと応答は遅くなりますか?
通すだけで増える時間の数字は、公式ページに見当たりません。数字があるのは Guardrails で、1件あたり約500ミリ秒増えるのが目安です。キャッシュに当たった答えは、提供元まで行かずに返ります。
日本語のプロンプトもGuardrailsで判定できますか?
2026年11月時点の公式ページでは、判定に使う Llama Guard の対応言語は英語など8つで、日本語は一覧にありません。どこまで判定できるかは書かれていないため、編集部はまず Flag(記録のみ)で結果を見てから Block にすることをすすめます。
プロンプトの中身を残さずに使えますか?
できます。ログはゲートウェイの設定で止められ、呼び出しごとに cf-aig-collect-log ヘッダーでも切り替えられます。ただし Unified Billing の呼び出しは、ログを止めても請求の明細が残ります。
使う人ごとに費用を分けて止められますか?
カスタムメタデータ(呼び出しに付ける目印)で利用者の ID を付け、支出上限のルールを Split by value にすると、人ごとに別の予算になります。Cloudflare Access で守ったゲートウェイなら、ID は自動で付きます。
この記事のポイント
- AI Gatewayはアプリと提供元の間で、呼び出しを記録・制限する
- 分析・キャッシュ・レート制限は無料。ログの料金は始めた日で違う
- キーを付けない呼び出しは、前払いクレジットから払われることがある
- 2026年11月から、新しいゲートウェイは認証が必須で外せない
まとめ
Cloudflare AI Gateway は、アプリと AI の提供元の間で呼び出しを記録し、キャッシュで節約し、回数と金額で止める入り口です。つなぎ方は3つで、中核機能は無料です。お金がかかる可能性があるのは、AI の利用料、Guardrails、ログの保存、Unified Billing の手数料などです。
まずは API トークンを作って default のゲートウェイで1回呼び、分析で量と費用を確かめます。外部のモデルを使うならキーの置き場所を決め、クレジットから払われたくなければ Require provider credentials をオンにします。






