401、403、同期拒否が出る場合は？

Token 全体、有効期限・失効状態、Account ID の一致、対象アカウントの AI Gateway Read、サーバーの IP 制限を確認します。モデル呼び出し成功は残高権限の証明ではありません。Global API Key、Cookie、全アカウント権限で代用しないでください。

ゼロ、負数、または他の Cloudflare 料金と異なるのは？

対象は Unified Billing の Credits のみで、BYOK と個別請求の Workers AI は含みません。Cloudflare が負の未決済 Credits を返す場合も保持します。同じアカウントの Credits Available と比較し、チャージ時の実支払額とは比較しません。

金額が 100 倍違う場合は？

新しい公開 API には単位の記載がなく、現在は旧パスの公式サンプルに従いセントを 100 で割って表示しています。実アカウントでの検証は未完了です。資金判断への利用を中止し、取得時刻と機密情報を除いたコンソール金額を報告してください。値の大きさから単位を推測したり、推定残高で代替したりはしません。

複数のプロジェクトで同額になるのは？

同一 Account ID の Gateway はアカウントの Credits を共有します。当サイトのプロジェクトは業務上の分類であり、Cloudflare に個別ウォレットを作るものではありません。同じ資金を重複加算しないでください。

入金が反映されない、または同期が失敗する場合は？

入金完了、アカウント、最終同期成功時刻を確認します。429 は時間を置いて再試行してください。API 停止や形式変更は明確に失敗と表示し、ゼロにはしません。更新は Cloudflare の決済を早めません。調査のために Token を公開する必要はありません。

Cloudflare AI Gateway 残高確認と API Token 設定

実アカウントでの確認待ち

ガイド更新日：2026-10-11

実装済みですが、実アカウントでの検証は未完了です。公開残高 API に単位の記載がないため、公式サンプルに従いセントから USD に換算しています。初回はコンソールの金額と単位を必ず照合してください。

必要な認証情報: Cloudflare API Token
監視通貨: USD · 米ドル
監視の対象: アカウント AI Gateway Credits; 選択した Cloudflare アカウントで共有する AI Gateway Unified Billing の Credits です。Gateway、API キー、当サイトのプロジェクト専用ウォレットでも、Cloudflare 全製品の総残高でもありません。

Cloudflare AI Gateway Credits を手動で確認する方法

Cloudflare Dashboard にログインし、実際に使っているアカウントを選択します。
AI → AI Gateway を開き、右上の Credits Available（USD）を確認します。
Manage でチャージ設定の確認や入金を行います。BYOK の資金や他の Cloudflare 製品の請求とは区別してください。

Cloudflare AI Gateway の公式ページを開く

Cloudflare AI Gateway を Quota Monitor に接続する

1. アカウントと Unified Billing を確認
Cloudflare Dashboard にログインし、実際に AI Gateway を使うアカウントを選び、AI → AI Gateway を開きます。右上の Credits Available とアカウント名を確認します。BYOK のみや別請求の Workers AI を使っていても、このウォレットに資金があるとは限りません。
確認：監視対象がこのアカウントの AI Gateway Credits であること。接続のためだけに入金したり、本番 Gateway の請求方式を変更したりする必要はありません。
Cloudflare AI Gateway の公式ページを開く（新しいタブで開きます）
2. Account ID をコピー
正しいアカウントで Ctrl+K / Cmd+K を押して検索を開き、Copy account ID と入力してコピーします。Workers & Pages → Account details の Account ID からも確認できます。
確認：32 桁の 16 進数の Account ID です。Zone ID、Gateway ID、アカウント名、URL ではありません。プロバイダーのプロジェクト ID 欄には入力しません。
Cloudflare AI Gateway の公式ページを開く（新しいタブで開きます）
3. 専用のカスタム API Token を作成
アバター → My Profile → API Tokens → Create Token を開きます。Custom token の Get started を選び、Quota Monitor AI Gateway と命名します。既存の本番 Token は変更せず、新規作成します。
確認：API Token の作成画面です。Global API Key の表示や、モデル呼び出し用 AI Gateway Run Token の作成ではありません。
Cloudflare AI Gateway の公式ページを開く（新しいタブで開きます）
4. 1 アカウントの読み取り権限だけを付与
Permissions で Account → AI Gateway → Read を選択します。Account Resources で Include → Specific account を選び、手順 1 のアカウントを指定します。無関係な権限行は削除し、All accounts、Write/Edit、Run は選びません。
確認：対象アカウントの AI Gateway Read だけです。この権限は残高以外の読み取りも許可しますが、当サイトは残高 API のみを呼び出します。権限やアカウントが見つからない場合は、広い権限で代用せず管理者に確認してください。
5. 制限を確認して Token 全体を保存
チームの方針に従って有効期限を設定します。Client IP Address Filtering を使用する場合、ブラウザーの IP ではなく Quota Monitor サーバーの実際の送信元 IP が必要です。不明なら管理者に確認し、既存の IP 制限を回避しないでください。Continue to summary で権限とアカウントを確認し、Create Token を押します。
通常、完全な Token は一度だけ表示されます。安全に保管してください。確認：Token ID ではなく秘密の Token 値で、Bearer 接頭辞を付けていないこと。チャット、スクリーンショット、MCP 引数に貼らないでください。
6. プロジェクト内に接続を保存
Quota Monitor で対象プロジェクト → プロバイダー接続を追加 → 新しい接続を選び、Cloudflare AI Gateway（USD Credits）を選択します。接続名、手順 2 の Account ID、手順 5 の API Token を入力して保存します。
両項目はマスク表示され、一緒に暗号化保存されます。一覧は Token の末尾 4 文字だけです。API URL、Gateway ID、プロバイダーのプロジェクト ID は不要です。MCP では安全な入力リンクを使用し、Agent に Token を送らないでください。
7. 同期して金額を照合
初回同期を待つか最新残高を取得し、新しい成功時刻を確認します。同じ Cloudflare アカウントの AI Gateway の Credits Available と USD 金額を比較します。Cloudflare 請求総額、Workers AI 使用量、BYOK ウォレットとは比較しません。
確認：アカウント、通貨、単位、時刻が一致すること。実アカウント検証は未完了なので、特に 100 倍の差がないか確認します。不一致ならエラーコード、時刻、機密情報を除いた金額だけを報告し、Token は送らないでください。失敗後の古い値は最新残高ではありません。
8. 必要なら公式サイトでチャージ
カードのプロバイダーを開くボタンから、同じアカウント → AI Gateway → Credits Available → Manage → Top-up credits を開きます。Cloudflare の現在の料金を確認してご自身で支払います。
確認：入金反映後に再同期します。当サイトはチャージ、オートリロードや支払い方法の変更を行わず、API が返すカード情報も保存しません。
9. 安全に置き換え・失効
手順 3～5 で別の専用読み取り Token を作り、その Account ID と Token で置き換え用の新規接続を追加します。同期成功後、古い接続を使う全プロジェクトから外し、接続管理で未使用になった接続を削除してから Cloudflare で古い Token を失効させます。プランに空き接続枠がなければ、先に切り替え時間を計画し、テストのためだけに本番認証情報を失効させないでください。
確認：他のアプリの本番認証情報を失効させていないこと。1 プロジェクトから外すだけでは Token は自動失効しません。監視を停止したら不要な専用 Token をご自身で失効させてください。

Quota Monitor が取得する Cloudflare AI Gateway のデータ範囲

Unified Billing で使う AI Gateway Credits のみを対象とします。BYOK は元のプロバイダーが請求するため、その残高は含みません。Workers AI は Gateway 経由で Unified Billing を使う場合だけこの Credits を消費し、他の請求経路は対象外です。
複数の Gateway、キー、プロジェクトが同じアカウントの Credits を共有します。同じ残高を重複加算しないでください。ゼロや負数でも、BYOK など別の請求方式が利用不能とは断定できません。
最新の成功した取得結果であり、上流の即時決済を保証しません。負数は保持します。失敗をゼロと表示したり、支払いや使用量から残高を推定したりしません。
セント単位は Cloudflare 公式 cloudflare-os の旧エンドポイント実装が根拠です。新しい公開パスの単位と実口座との照合は未検証です。初回に Credits Available と比較し、100 倍の差があれば金額に基づく判断を中止して報告してください。換算率を手動で変えないでください。
ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。

Cloudflare AI Gateway のよくある質問とトラブルシューティング

401、403、同期拒否が出る場合は？: Token 全体、有効期限・失効状態、Account ID の一致、対象アカウントの AI Gateway Read、サーバーの IP 制限を確認します。モデル呼び出し成功は残高権限の証明ではありません。Global API Key、Cookie、全アカウント権限で代用しないでください。
ゼロ、負数、または他の Cloudflare 料金と異なるのは？: 対象は Unified Billing の Credits のみで、BYOK と個別請求の Workers AI は含みません。Cloudflare が負の未決済 Credits を返す場合も保持します。同じアカウントの Credits Available と比較し、チャージ時の実支払額とは比較しません。
金額が 100 倍違う場合は？: 新しい公開 API には単位の記載がなく、現在は旧パスの公式サンプルに従いセントを 100 で割って表示しています。実アカウントでの検証は未完了です。資金判断への利用を中止し、取得時刻と機密情報を除いたコンソール金額を報告してください。値の大きさから単位を推測したり、推定残高で代替したりはしません。
複数のプロジェクトで同額になるのは？: 同一 Account ID の Gateway はアカウントの Credits を共有します。当サイトのプロジェクトは業務上の分類であり、Cloudflare に個別ウォレットを作るものではありません。同じ資金を重複加算しないでください。
入金が反映されない、または同期が失敗する場合は？: 入金完了、アカウント、最終同期成功時刻を確認します。429 は時間を置いて再試行してください。API 停止や形式変更は明確に失敗と表示し、ゼロにはしません。更新は Cloudflare の決済を早めません。調査のために Token を公開する必要はありません。

Cloudflare AI Gateway の公式資料

Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。