Google AI StudioでAPIキーを発行する操作自体は短時間です。しかし、運用可能な状態は「文字列をコピーした」ではありません。キーの所属プロジェクトが正しく、secretがclient codeから分離され、最小のGemini Developer APIリクエストで成功または診断可能なerrorを得られて初めて、接続を管理できます。
APIキーはGeminiの個人向けサブスクリプションでも、モデル利用権のセットでもありません。Google Cloudプロジェクトに紐づく認証情報です。
発行前に3つだけ決める
最初に Google AI StudioとGemini APIの利用可能地域を確認します。日本は2026年8月29日の確認時点で一覧に含まれています。ただし、国が一覧にあることは個別のアカウント、18歳以上、年齢確認、組織policy、支払い方法まで保証しません。AI Studioに表示されたaccount-specificな案内も満たす必要があります。
次に、プロジェクトownerを決めます。個人検証なら本人、会社のサービスなら組織が管理するアカウントとCloudプロジェクトを使います。発行者の退職後もbilling、rotation、revokeを実行できる体制が必要です。
最後に、最初の目的を1つに絞ります。ここでは「キー発行と認証確認」だけです。Free/Paidの選択、production quota、モデル価格はcanary成功後に判断します。
正しいプロジェクトで現在のキーを作る
Google AI Studio API Keysを開きます。Googleの現行 Gemini APIキー文書では、初めて利用するユーザーに規約同意後のdefault Cloud projectとAPI keyが作られる場合があります。既にCloudを利用しているアカウントでは自動作成されず、Dashboard → Projects → Import projects から対象projectをimportする場合があります。
同じような表示名が並んでも、後で確実に照合できるのは project ID です。作成前にproject IDと管理者を記録し、API Keys画面で Create API key を実行します。
ボタンが無効でpermission不足と表示されたら、選択projectを再確認します。Googleはproject参照、key作成、Generative Language API有効化、service account作成、API key bindingに必要な権限を示しています。Ownerを広く付与するのではなく、組織管理者に必要な権限を確認してもらいます。
Key Type列は必ず確認する
AI Studioで新規作成されるキーは現在 authorization key（auth key）です。service accountにboundされ、Gemini APIに制限される設計です。Googleはstandard keyからauth keyへ移行しており、現行文書は 2026年9月にstandard keyを拒否すると記載しています。
この期限は変わり得ます。公開直前やmigration時に公式ページを再確認してください。古い記事のunrestricted standard keyを新規システムの前提にしないことが重要です。
secretを環境変数に置く
キーはpasswordと同じです。Git、issue、スクリーンショット、frontend JavaScript、mobile binary、公開URLに含めません。productionではsecret managerに保存し、browser/mobileは自分のbackendを経由して呼び出します。
Googleのclient libraryは GEMINI_API_KEY または GOOGLE_API_KEY を自動検出します。両方がある場合は GOOGLE_API_KEY が優先されるため、意図しない古いキーを使っていないか注意します。
bashexport GEMINI_API_KEY="YOUR_API_KEY"
値を表示せず設定だけ確認できます。
bashif [ -n "${GEMINI_API_KEY:-}" ]; then echo "GEMINI_API_KEY: set" else echo "GEMINI_API_KEY: missing" fi
1回のcanaryで認証を確認する
現在の Google get-startedはInteractions endpointとgemini-3.7-flashを例にしています。キーをURLではなくheaderで渡します。
bashcurl -sS -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \ -H "x-goog-api-key: $GEMINI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gemini-3.7-flash", "input": "API接続が動作したことを短い一文で返してください。" }'
成功判定は、特定の日本語フレーズではありません。期待したhostnameへ到達し、目的のproject credentialで認証され、completedなinteractionとoutputを含む構造化responseが返ることです。
model IDとAPI surfaceは更新されます。現行quickstartが別の例に変わったら、その例へ更新します。古いmodel IDを推測して繰り返す必要はありません。
errorを消さずに切り分ける
最初の失敗は有用な証拠です。HTTP status、secretを除いたbody、project ID、endpoint、model、UTC時刻、request IDを保存します。キー全体や環境dumpは保存しません。
| 観測した状態 | 最初に見るowner | 次の一手 |
|---|---|---|
| Key管理画面に到達できない | region、age verification、account/organization policy | 公式条件を確認し、非適合ならdirect routeを停止 |
| Create API keyが無効 | project import、IAM | project IDを固定して管理者へ必要権限を確認 |
403 PERMISSION_DENIED | active key、project、restriction、action | 403の切り分けを実行 |
429 RESOURCE_EXHAUSTED | project/model/tierのlive limit | AI Studioの値とrate limitガイドを確認 |
| model/routeが見つからない | 現行model ID、API version | get-startedの最新例で1回だけ再試行 |
| 一時的なserver error | service status、retry | 上限付きexponential backoff。別キーは作らない |
一度にkey、project、model、endpointを変えると、何が直ったのか分かりません。1つ変えて同じcanaryを再実行します。
FreeとPaidは接続後に判断する
キー発行自体に「キー価格」はありません。Freeは対象modelとserving modeに限られ、実際のRPM/TPM/RPDは選択projectとmodelについてAI Studioが表示するactive limitです。同一projectのキーを増やしても別quotaにはなりません。
本番workloadにbillingが必要かは、canary成功後に入力/出力量、model、latency、rate limitを測って決めます。費用判断は Gemini API料金ガイドと現在の公式pricingで行います。
運用前の最終記録は短くて構いません。project ID、credential owner、Key Type、secret保存先、rotation担当、許可backend、model、AI Studio live limit、billing status。この9項目があれば、漏えいや異動時に対象を迷わずrevokeできます。
