Gemini APIキーの取得・設定方法｜AI Studioと認証キーへの移行を確認

Geminiの月額プランとAPIの利用は分けて確認

Geminiアプリで会話する契約と、自分のプログラムからAPIを呼ぶ利用は別に確認します。アプリ側が有料だから、APIも無制限で使えるとは考えないようにします。

APIでは、利用するモデル、量、無料枠や課金設定が関係します。最初は短い文章を一回だけ送る構成にし、利用状況を見てから繰り返し処理へ広げると、どの作業で使ったか追いやすくなります。

• 出典：Gemini APIキーの種類・作成・移行（新しいタブ）
• 出典：Gemini APIのクイックスタート（新しいタブ）

2026年9月は、キーの種類も確認する

公式は標準キーから認証キーへ移行し、2026年9月に標準キーの要求を拒否する方針を案内しています。現在AI Studioで作る新しいキーは認証キーが既定です。古いキーを持っている場合は、キー一覧の種類を確認します。

認証キーはサービスアカウントという、プログラム用の身元へ結び付く仕組みです。人のログインとは別です。標準キーへ制限を付けるだけで、認証キーへの移行が済んだと考えないでください。具体的な停止日や自分のキーの動作は、表示と最新案内で確認します。

AI Studioで、使うプロジェクトを選んで作る

Google AI Studioのダッシュボードでプロジェクトを確認し、API Keysからキーを作成します。既存のCloudプロジェクトが一覧にない場合は、Projectsのインポートが必要になることがあります。

会社のプロジェクトで作成ボタンが使えない場合は、管理者に必要な権限を確認します。権限不足を避けるために仕事のデータを個人プロジェクトへ移すのではなく、どこで使うべきかを先に決めます。キーの文字列はチャットやスクリーンショットへ載せないでください。

環境変数に保存し、値を表示せず設定を確認

環境変数は、プログラムの外から設定を渡す方法です。GEMINI_API_KEYという名前で保存し、プログラム側が読み取る形にします。GOOGLE_API_KEYも設定してある場合は、公式ではそちらが優先されるため、意図しないプロジェクトを使わないか確認します。

設定を変えた後はターミナルや開発サーバーを開き直します。次の確認はキーそのものを表示せず、環境変数があるかだけを出すNode.jsの例です。これで「設定あり」でも、認証や課金が成功したことにはなりません。

小さな要求で、認証・権限・利用枠を切り分ける

公式クイックスタートの現行SDKとモデル名で、一つの短い入力を試します。古いブログのモデル名が終了している場合もあるため、キーだけを作り直し続けないようにします。

エラーの本文には、認証、権限、課金、利用枠などの手がかりがあります。再試行を無限に回す前に、プロジェクト、キーの種類、APIの有効化、対象モデルの条件を確認してください。

• 出典：Gemini APIの課金（新しいタブ）
• 出典：Gemini APIの問題解決（新しいタブ）

Webへ公開するときは、キーをブラウザへ渡さない

環境変数に入れたつもりでも、Web画面へ埋め込まれる変数として扱えば外から読めてしまいます。利用者のブラウザへ配信するコードにキーを含めず、API呼び出しはサーバー側で行います。

キーが漏れた可能性がある場合は、新しいキーへの切り替え、旧キーの無効化、利用状況の確認を行います。アプリ全体の設計まで学びたい人には、認証や評価を含むAI開発の技術書も候補です。APIキー一つを作るだけなら、まず公式手順と最小の動作確認で進められます。