Gemini API の費用・上限監視とサービスアカウント設定

Gemini API の使用量・請求・利用上限を手動で確認する方法

1. AI Studio の Billing ページで、請求先アカウント、前払いクレジット、費用の内訳を確認します。
2. Spend ページの Monthly spend cap で、プロジェクトの月間利用上限を確認・変更します。
3. SKU 単位で確認するには、Google Cloud コンソールの Cloud Billing レポートを開き、SKU でグループ化して Gemini API サービスに絞り込みます。
4. 請求データの処理には約 10 分かかり、Billing と Spend ページの費用グラフの更新には最大 24 時間かかることがあります。

Gemini / Google AI Studio を Quota Monitor に接続する

1. 01

   1. 費用監視が目的に合うか確認する

   Gemini API を管理するアカウントで Google AI Studio にログインします。正確な前払い残高は公式 Billing で確認してください。本機能では代替できません。権限設定はプロジェクト管理者、定期取得は専用サービスアカウントが担当します。確認：24 時間以上の遅延を許容し、差額をウォレット残高として扱わないこと。

   Gemini / Google AI Studio の公式ページを開く（新しいタブで開きます）
2. 02

   2. モデルキーの Google Cloud プロジェクトを特定する

   AI Studio → API Keys で業務キーの所属プロジェクトを確認し、Google Cloud 上部のプロジェクト選択でも同じものを選びます。プロジェクト設定から Project ID（例 my-gemini-project）をコピーします。表示名や数字の Project number、モデルキーそのものではありません。Billing で請求先が関連付いていることと通貨を確認します。確認：Project ID、業務キーの所属、請求通貨が一致していること。

   Gemini / Google AI Studio の公式ページを開く（新しいタブで開きます）
3. 03

   3. 必要な API を有効にする

   対象プロジェクトを選んだまま APIs & Services → Library を開き、App Optimize API、Cloud Billing API、Cloud Billing Budget API、Cloud Resource Manager API を検索して有効にします。有効済みのものは変更不要です。App Optimize はプレビューで、組織が禁止している場合は停止して管理者に相談し、安全設定を弱めないでください。確認：有効な API に appoptimize.googleapis.com、cloudbilling.googleapis.com、billingbudgets.googleapis.com、cloudresourcemanager.googleapis.com があること。

   Gemini / Google AI Studio の公式ページを開く（新しいタブで開きます）
4. 04

   4. プロジェクト用の最小権限ロールを作成する

   管理者がコンソール上部から Cloud Shell を起動し、対象プロジェクトを確認します。Cloud Shell エディタの File → New File で quota-monitor-gemini-role.json を作り、以下の JSON 全体を貼り付けて保存します。ターミナルで gcloud iam roles create QuotaMonitorGeminiCost --project=PROJECT_ID --file=quota-monitor-gemini-role.json を実行します。PROJECT_ID は手順 2 の値に置き換えてください。

   同名ロールがある場合は IAM & Admin → Roles で内容を調べ、用途と権限が一致する場合のみ再利用します。他の業務用ロールを上書きしないでください。Cloud Shell は Google 側の環境です。確認：対象プロジェクトに QuotaMonitorGeminiCost があり、以下の 7 権限だけを含むこと。ロール作成だけでは権限は付与されません。

   費用レポート用ロール JSON（一時レポート作成を含む）

   JSON をコピー

   {
     "title": "Quota Monitor Gemini Cost",
     "description": "Read project costs and budgets; create temporary cost reports.",
     "stage": "BETA",
     "includedPermissions": [
       "appoptimize.reports.create",
       "appoptimize.reports.getData",
       "appoptimize.operations.get",
       "billing.resourceCosts.get",
       "billing.resourcebudgets.read",
       "resourcemanager.projects.get",
       "serviceusage.services.use"
     ]
   }

   キーやアカウント情報を含まない JSON 全体をコピーします。

   Gemini / Google AI Studio の公式ページを開く（新しいタブで開きます）
5. 05

   5. 専用サービスアカウントを作成する

   同じプロジェクトの IAM & Admin → Service Accounts → Create service account で quota-monitor-gemini という名前を付けます。任意のロールやユーザーアクセス付与はスキップし、次の手順で正確に付与します。これはプログラム用の ID で、個人の Google ログインではありません。確認：.iam.gserviceaccount.com で終わる完全なメールを記録し、継承を含め Owner/Editor などの広い権限がないこと。

   Gemini / Google AI Studio の公式ページを開く（新しいタブで開きます）
6. 06

   6. サービスアカウントにロールを付与する

   対象プロジェクトの IAM → Grant access で New principals に手順 5 のメールを入力します。Select a role で Quota Monitor Gemini Cost を検索して選び、保存します。自分のログインメールや Viewer/Editor/Owner テンプレートを使わないでください。確認：そのサービスアカウントの IAM 行に、手順 4 のカスタムロールが実際に割り当てられていること。定義のみでは照会は許可されません。

   Gemini / Google AI Studio の公式ページを開く（新しいタブで開きます）
7. 07

   7. JSON 秘密鍵を作り、安全に保管する

   Service Accounts で専用アカウントを開き、Keys → Add key → Create new key → JSON → Create と進みます。ダウンロードしたファイルを安全なエディタで開き、type が service_account、project_id が対象プロジェクトで、private_key、private_key_id、client_email があることを確認します。API Keys のモデルキーでは代用できません。

   長期利用できる秘密鍵を含むため、パスワードマネージャーなど安全な場所に保管し、Git、チャット、問い合わせには貼らないでください。組織が鍵作成を禁止している場合、この版では代替認証に未対応です。禁止を解除しないでください。確認：完全な JSON が安全に保存され、Keys に不要な鍵がないこと。

   Gemini / Google AI Studio の公式ページを開く（新しいタブで開きます）
8. 08

   8. 任意：既存の Cloud Billing 利用上限を確認する

   請求またはプロジェクト管理者が Billing → Budgets & alerts で Gemini の予算を開きます。対象は実際の Spend cap で、この 1 プロジェクトと Gemini API サービス、Month、全 Credits 除外に限ります。メール通知のみの予算は硬い上限ではなく、複数プロジェクトや別サービスの予算も適用しません。

   接続のために本番の上限を新設・変更する必要はありません。該当上限なしでも費用を取得できます。AI Studio で作った上限は Cloud Billing の上限とは限りません。確認：比較対象の上限がどれかを把握している、または費用のみでよいこと。本站は上限を新設・変更・解除しません。

   Gemini / Google AI Studio の公式ページを開く（新しいタブで開きます）
9. 09

   9. Quota Monitor のプロジェクト内で接続を追加する

   業務プロジェクト → 供給元の接続追加 → Gemini / Google AI Studio（費用・上限）を選びます。接続名を付け、JSON ファイル全体をマスク付き Google サービスアカウント JSON 欄に貼り付けます。チャットには貼らないでください。Google Cloud プロジェクト ID が空なら JSON の project_id を使います。別プロジェクトでは先にその API と同じサービスアカウントのロール付与を設定してから、その Project ID を入力します。

   Google 請求通貨には手順 2 で確認した USD、CNY、JPY など大文字 3 文字を入れます。換算は行いません。保存してプロジェクトに接続します。確認：正しい業務プロジェクトに接続があり、秘密鍵が再表示されないこと。保存エラーでは形式と権限を調べ、JSON を公開しないでください。

10. 10

    10. 同期し、費用・上限・差額を区別する

    初回同期を待つか、費用同期を押します。短期アクセストークンと Gemini SKU 一覧を取得し、一時費用レポートを作成・読み取りした後、該当上限を別途取得します。費用の全ページ取得が完了しない場合は部分合計を保存しません。上限の取得だけが失敗した場合、費用は保持して上限を取得不可とします。確認：カードは残高ではなく報告済み費用で、太平洋時間の月と遅延の注記があること。上限、報告からの差額、公式制限状態は別々です。

11. 11

    11. Google と同じ範囲で照合する

    Cloud Billing Reports で同じプロジェクト、当月、Gemini API サービスを選び、同じ通貨の Credits 適用前費用と比較します。請求先全体、Vertex AI、Credits 適用後費用、AI Studio 前払い残高とは比較しません。Cloud Billing の Spend cap と AI Studio の Limits も別途確認します。確認：時刻、サービス、プロジェクト、費用基準が同じこと。直近の利用は反映を待ち、正の差額だけで呼び出し可能と判断しないでください。

    Gemini / Google AI Studio の公式ページを開く（新しいタブで開きます）
12. 12

    12. 鍵を定期更新し、不要な権限を撤回する

    専用アカウントの Keys で新 JSON を作り、本站の接続管理で認証情報を更新して同期成功を確認してから旧鍵を削除します。停止時はプロジェクトの監視を外すか接続を削除し、Google 側で専用鍵と不要なロール割り当てを撤回します。他の業務の ID やロールは削除しないでください。確認：旧鍵が無効で必要な権限だけが残ること。問い合わせにはエラーコードと時刻のみを記載し、秘密鍵やトークンを送らないでください。

Quota Monitor が取得する Gemini / Google AI Studio のデータ範囲

• App Optimize はプレビューです。費用の反映は通常 1 日以内ですが、24 時間以上遅れることがあります。更新は報告済みデータの再取得で、同期時刻は精算時刻ではありません。ゼロは該当する報告がないことを意味し、消費なしや利用可能性を保証しません。
• Gemini 前払い残高、個人向け Gemini サブスクリプション、Vertex AI、請求先アカウント全体は対象外です。API キー単位の費用絞り込みはできず、同じ Google プロジェクトのキーは費用範囲を共有します。
• 単一プロジェクト、Gemini サービス、月次、全クレジット除外に一致する Cloud Billing の実際の spendCap のみ読み取ります。通知専用の予算は利用上限ではありません。AI Studio 独自の上限や請求先アカウントの tier 上限は対象外です。
• 差額は同一通貨・同一範囲の上限から報告済み費用を引いた値で、リアルタイムの利用可能額ではありません。制限判定はより早い推定費用を使うため、正の差額があっても停止する場合があります。権限不足、ページ取得失敗、設定変更中は取得不可とし、ゼロや無制限には置き換えません。
• 同期ごとに対象プロジェクトに一時レポートを作成し、Google が 24 時間後に期限切れとして削除します。請求変更やチャージ権限ではありません。プレビュー中のレポート API に追加 API 料金はありませんが、Google の規約、割り当て、他のクラウド料金は適用されます。
• ガイドと模擬テストは実アカウント検証ではありません。まず小規模で権限を制限したプロジェクトで照合してください。トラブル解決のために管理者権限を付与したり、組織のセキュリティ制御を無効化したり、秘密鍵を共有したりしないでください。
• 最新の同期成功時の費用を表示します。更新しても上流の報告遅延はなくなりません。失敗後の古い費用と時刻は新しいレポートではありません。

Gemini / Google AI Studio のよくある質問とトラブルシューティング

モデル API キーが使えないのはなぜ？

モデルキーはモデル呼び出し用で、費用レポートや IAM 権限を代替しません。手順 4–7 で最小権限サービスアカウントと JSON 鍵を作成してください。ユーザー OAuth、Cookie、外部 ID 設定には未対応です。

403、API 無効、ロール作成エラーの場合は？

選択中のプロジェクト、4 API、サービスアカウントのメール、カスタムロール割り当てを順に確認します。billing.resourcebudgets.read は単一プロジェクトの予算参照用で、請求先全体の管理権限は不要です。プレビューやカスタムロールが制限される場合は管理者に確認し、Owner/Editor で回避しないでください。

同期成功でもゼロ、または変化しないのは？

該当する Gemini の報告済み費用がない状態です。プロジェクトや Vertex AI 経由かを確認し、24 時間以上かかる場合もある報告を待ってください。更新は精算を早めず、残高があることも証明しません。

費用はあるのに上限が取得不可・未設定なのは？

単一プロジェクト予算の参照権限、Gemini/月次/Credits 除外の範囲、実際の Spend cap を確認します。通知予算、他サービス、複数プロジェクト、AI Studio 上限は対象外です。変更中、重複、一致しない通貨、API 失敗は取得不可となり、ゼロにはなりません。

通貨や請求額が一致しないのは？

公式レポートの 3 文字通貨を設定してください。換算や誤ったドル表示は行いません。太平洋時間の月、対象プロジェクト、Gemini、Credits 前の費用、報告遅延をそろえます。複数通貨が混ざる場合は合計せず取得を失敗させます。

差額が残るのに呼び出しが止まるのは？

制限判定はより早い方向性費用データを使い、AI Studio 上限、アカウント制限、実資金条件も影響します。この差額は費用情報で、モデル利用の保証ではありません。Google 側の停止理由を確認してください。

Gemini API が 402 Payment Required を返すのはなぜですか？

Google はこれを前払い（Prepay）クレジット残高の枯渇と説明しています。請求先アカウントの残高が 0 になると、そのアカウントに紐づくすべてのプロジェクトのすべての API キーが同時に停止し、クレジットを追加するか自動チャージを有効にするまで再試行は成功しません。前払いクレジットは購入から 12 か月で失効します。請求先アカウントが利用ティアの月間上限に達した場合も、紐づくプロジェクトは翌月 1 日まで停止します。Quota Monitor が取得するのは報告済み費用と Cloud Billing の利用上限で、前払いクレジット残高は取得しません。

Gemini / Google AI Studio の公式資料

• 公式資料 · ai.google.dev/gemini-api/docs/billing（新しいタブで開きます）
• 公式資料 · docs.cloud.google.com/app-optimize/create-read-report（新しいタブで開きます）
• 公式資料 · docs.cloud.google.com/app-optimize/optimization-data（新しいタブで開きます）
• 公式資料 · docs.cloud.google.com/app-optimize/about-reports（新しいタブで開きます）
• 公式資料 · docs.cloud.google.com/app-optimize/access-control（新しいタブで開きます）
• 公式資料 · docs.cloud.google.com/billing/docs/how-to/budgets-spend-caps（新しいタブで開きます）
• 公式資料 · docs.cloud.google.com/billing/docs/how-to/budget-api-access-control（新しいタブで開きます）
• 公式資料 · docs.cloud.google.com/billing/docs/reference/rest/v1/services.skus/list（新しいタブで開きます）
• 公式資料 · docs.cloud.google.com/iam/docs/creating-custom-roles（新しいタブで開きます）
• 公式資料 · developers.google.com/identity/protocols/oauth2/service-account（新しいタブで開きます）
• 公式資料 · docs.cloud.google.com/iam/docs/keys-create-delete（新しいタブで開きます）
• 公式資料 · docs.cloud.google.com/app-optimize/overview（新しいタブで開きます）
• 公式資料 · ai.google.dev/gemini-api/docs/api-errors（新しいタブで開きます）

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