ツール連携2026年10月23日Flatkey Team

Google Gemini APIキーの取得方法（2026年）：作成・動作確認から本番環境のセキュリティ対策まで

AI StudioでのGoogle Gemini APIキーの作成、環境変数への設定、初回リクエスト、無料枠と有料枠の制限の確認、本番運用前のセキュリティ対策まで、手順に沿って解説します。

Google Gemini APIキーの取得方法（2026年）：作成・動作確認から本番環境のセキュリティ対策まで

Google Gemini APIキーを取得するには、GoogleアカウントでGoogle AI Studioにログインし、利用規約に同意して、APIキーのページで「APIキーを作成」をクリックします。新規ユーザーには、デフォルトのGoogle Cloudプロジェクトとキーが自動で作成されます。キーの作成は無料で、Gemini 3.8 FlashやGemini 3.5 Flash-Liteなど、複数のGeminiモデルに無料枠が用意されています。2026年5月28日以降、AI Studioで新規作成されるキーはすべて、サービスアカウントに紐づく「認可キー」になりました。また、Gemini APIは制限のない旧式のキーを拒否するため、昨年使えていたキーでも再作成が必要な場合があります（GoogleのAPIキーのドキュメント、2026年10月27日確認）。

このガイドは、Geminiキーをすぐに使い始め、本番環境でも安全に運用したい個人開発者や小規模チーム向けです。取得手順、新しいキーの種類、無料枠、curl・Python・Node.jsでの初回リクエスト、よくあるエラー、本番運用前のチェックリストを紹介します。費用を比較したい方は、料金表を網羅したGemini API料金ガイドをご覧ください。

Gemini APIキーを取得する手順

Google AI Studioを開く。 aistudio.google.com/apikeyにアクセスし、課金先またはプロジェクトの所有者にするGoogleアカウントでログインします。
利用規約に同意する。 新規ユーザーの場合、利用規約に同意すると、AI StudioがデフォルトのGoogle CloudプロジェクトとAPIキーを作成します。プロジェクト名は、後からプロジェクト画面で変更できます。
プロジェクトを選択またはインポートする。 すでにGoogle Cloudを利用している場合、AI Studioはデフォルトのプロジェクトを作成しません。ダッシュボード → プロジェクト → プロジェクトをインポートを開き、使用するCloudプロジェクトを選択します。
キーを作成する。 APIキーのページでAPIキーを作成をクリックし、プロジェクトを選択します。新しいキーはデフォルトで認可キーになります。
コピーしたら、すぐに安全な場所へ保存する。 リポジトリ内のファイルには保存せず、環境変数またはシークレット管理サービスに直接保存します。
制限を設定する。 Geminiの呼び出しだけに使うキーは、Gemini API（Generative Language API）のみに制限します。固定のサーバーから使う場合は、Google CloudコンソールでIP制限も追加します。
動作を確認する。 以下のリクエストのいずれかでテストします。

手順はGoogle AI for DevelopersのGemini APIキーの使用（最終更新：2026年10月27日）に基づいています。

後からGoogle APIキーを確認するには？

Google AI Studioでダッシュボード → APIキーを開きます。AI Studioには最大100個のキーと50個のプロジェクトが表示されますが、表示対象のキーは、制限がないものか、Gemini APIに制限されているものだけです。他のGoogle APIに制限されているキーは、Google Cloudコンソールの認証情報ページにのみ表示されます。プロジェクトが見つからない場合は、先にインポートしてください。

標準キーと認可キー：2026年の変更点

Googleは、Gemini APIで使うキーを標準APIキーから認可（auth）キーへ移行しています。公式ドキュメント（2026年10月27日）によると、違いは次のとおりです。

	標準APIキー	認可キー
紐づく対象	課金とクォータを管理するGoogle Cloudプロジェクト	Google Cloudサービスアカウント
呼び出し元の識別	なし	あり。紐づけられたサービスアカウントとしてリクエストを実行
デフォルトのスコープ	追加した制限によって異なる	デフォルトでGemini APIのみに制限
キー漏洩時の対応	手動	Googleが漏洩を検出したキーの利用を速やかに停止
AI Studioでの作成時期	2026年5月28日より前	2026年5月28日以降
現在も使えるか	明示的に制限を設定している場合のみ	使用可能

実際の運用には、次のような影響があります。

制限のない標準キーは拒否されます。 古いキーにAPI制限が設定されていないと、Geminiへのリクエストは失敗します。AI Studioでキーの警告ラベルにカーソルを合わせ、Gemini APIのみに制限を選択してください。apikeys.keys.update権限が必要です。
長期間使われていない、制限のないキーはブロックされます。 2026年5月7日以降、制限がなく長期間使われていないキーには、ブロック済みタグが表示されます。新しいキーを作成し、アプリで使うキーを切り替えてください。
新しいキーのプレフィックス。 新しい認可キーは、従来のAIzaで始まらなくなったという開発者の報告があります（報告記事の例）。サードパーティーツールがプレフィックスでキーを検証していると、有効な新しいキーでも拒否される場合があります。標準キーに戻すのではなく、ツールを更新してください。
キーの作成に必要な権限。 作成ボタンに権限不足のメッセージが表示される場合、Cloud管理者に、apikeys.keys.create、serviceusage.services.enable、iam.serviceAccounts.create、iam.serviceAccountApiKeyBindings.createなどの権限を含むロールを付与してもらう必要があります。管理者権限がない場合は、組織に属さない新しいプロジェクトを作成できます。

キーを環境変数に設定する

Googleのクライアントライブラリは、GEMINI_API_KEYまたはGOOGLE_API_KEYを自動で読み取ります。両方が設定されている場合は、GOOGLE_API_KEYが優先されます。 「新しいキーが使われない」という問題でよくある原因です。

# macOS / Linux (add to ~/.zshrc or ~/.bashrc, then open a new terminal)
export GEMINI_API_KEY="paste-your-key-here"

# Make sure an old key is not overriding it
unset GOOGLE_API_KEY

Windowsでは、システムのプロパティ → 環境変数でGEMINI_API_KEYを追加し、新しいターミナルを開いてください。

Gemini APIキーの動作を確認する

curl（Interactions API）

Googleの現在のクイックスタートでは、x-goog-api-keyヘッダーにキーを設定してInteractionsエンドポイントを呼び出します。

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Reply with the single word: ok"
  }'

出力テキストを含むJSONレスポンスが返れば、キー、プロジェクト、モデルへのアクセスがすべて正常に機能しています。403は通常、キーが他のAPIに制限されているか、ブロックされていることを示します。429はレート制限への到達を示します（後述）。

Python（google-genai SDK）

# pip install google-genai
from google import genai

client = genai.Client()  # reads GEMINI_API_KEY from the environment

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explain what an API key is in one sentence.",
)
print(interaction.output_text)

Node.js（@google/genai）

// npm install @google/genai
import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

const interaction = await ai.interactions.create({
  model: "gemini-3.8-flash",
  input: "Explain what an API key is in one sentence.",
});
console.log(interaction.output_text);

同じキーをOpenAI SDKで使う

GeminiはOpenAI互換エンドポイントも提供しています。多くのコーディングエージェントやチャットアプリなど、OpenAI形式のベースURLしか受け付けないツールで便利です。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GEMINI_API_KEY"],
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
)
resp = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[{"role": "user", "content": "Say ok"}],
)
print(resp.choices[0].message.content)

1つのゲートウェイを通じたツール別の設定方法は、OpenAI互換ルーター経由でGemini APIを使う方法をご覧ください。

Gemini APIキーは無料？

キーの作成は無料で、利用量に制限のある無料枠もあります。Googleの料金ページ（2026年10月27日確認）には、Free、Paid、Enterpriseの3つのプランが記載されています。無料枠では、一部モデルの入力・出力トークンを無料で利用できますが、無料枠で送信したコンテンツはGoogleのプロダクト改善に使われます。 有料枠では使われません。無料枠のキーで顧客データを送信しないでください。

モデル	無料枠	有料枠の1Mトークンあたりの入力 / 出力料金（標準）
Gemini 4 Argon	なし	2026年11月30日まで$2.00 / $10.00、2026年12月1日から$4.00 / $20.00
Gemini 3.8 Flash	あり	2026年12月31日まで$0.75 / $3.75、2027年1月1日から$1.50 / $7.50
Gemini 3.5 Flash-Lite	あり	$0.30 / $2.50
Gemini 3.1 Flash-Lite	あり	$0.25 / $1.50（テキスト、画像、動画）

出典：Gemini Developer APIの料金、2026年10月27日。予定されている値上げに注意してください。それぞれの日付以降もアプリを運用する場合は、値上げ後の料金で予算を見積もりましょう。

Gemini APIを無料で使う方法

AI Studioで、請求先を紐づけずにキーを作成します。プロジェクトはFree枠のままになります。
gemini-3.8-flashやgemini-3.5-flash-liteなど、無料枠のあるモデルを使います。Gemini 4 Argonは有料のみです。
AI Studioに表示される無料枠のレート制限内で利用します。制限はキー単位ではなく、プロジェクト単位で適用されるため、同じプロジェクトでキーを増やしてもクォータは増えません。
無料枠のコンテンツはGoogleのプロダクト改善に使われる可能性があるため、テスト用データまたは公開データだけを使います。

レート制限とティア

Geminiのレート制限は、1分あたりのリクエスト数（RPM）、1分あたりの入力トークン数（TPM）、1日あたりのリクエスト数（RPD）で管理されます。いずれか1つでも超過するとエラーになり、RPDは太平洋時間の午前0時にリセットされます（レート制限、2026年10月27日）。Googleは直近10分間の支出額に基づく制限も適用しており、これを超えると429 RESOURCE_EXHAUSTEDが返ります。

ティア	適用条件	課金ティアの上限
Free	有効なプロジェクトまたは無料トライアル	N/A
Tier 1	有効な請求先アカウントを紐づける	$250
Tier 2	支払額$100 + 初回の支払い成功から3日経過	$2,000
Tier 3	支払額$1,000 + 初回の支払い成功から30日経過	$20,000～$100,000+

出典：Gemini APIのレート制限、2026年10月27日。モデルごとの正確な制限はAI Studioで確認してください。Googleによると、記載されている上限値は保証されていません。

APIキーを第三者に知られると何が起きる？

Geminiキーを入手した人は、あなたのプロジェクトに課金されるリクエストを送信し、クォータを使い切ることができます。Googleのドキュメントでは、キーの漏洩によって「予期しない請求」やプロジェクト内の非公開データへのアクセスが発生するおそれがあると警告しています。認可キーの場合、攻撃者は紐づけられたサービスアカウントとして操作し、そのアカウントがアクセスできる対象すべてにアクセスできます（Google CloudのAPIキーに関するベストプラクティス）。そのため、サービスアカウントの権限は必要最小限に抑えてください。

キーの漏洩が疑われる場合は、次の手順で対応します。

AI Studioで代替のキーを作成します。
新しいキーをアプリにデプロイし、正常に動くことを確認します。
Cloudコンソールで古いキーを無効にします。新しいキーが稼働する前に古いキーを削除すると、サービス停止を招きます。
Cloudコンソールで請求とAPIの使用状況を確認し、身に覚えのないトラフィックがないか調べます。AI Studioの使用状況ページでは、名前付きのキーに紐づけられないトラフィックは「（不明なキー）」としてまとめられます。

トラブルシューティング：Gemini APIキーが動かない原因

症状	考えられる原因	対処方法
古いキーで`403`または「APIキーが無効」と表示される	制限のない標準キーが拒否されるようになった	Gemini APIのみに制限するか、新しい認可キーを作成する
AI Studioでキーにブロック済みと表示される	長期間使われていない、制限のないキーが2026年5月7日以降ブロックされた	新しいキーを作成し、アプリの設定を更新する
コードで新しいキーが使われない	`GOOGLE_API_KEY`も設定されており、そちらが優先されている	その設定を解除するか、新しいキーに変更する
サードパーティーツールでキーの形式が正しくないと表示される	ツールが古いプレフィックスを想定している	ツールを更新するか、OpenAI互換ゲートウェイ経由で利用する
「キーを作成する権限がありません」と表示される	CloudプロジェクトのIAM権限が不足している	管理者に依頼するか、組織外のプロジェクトを使う
`429 RESOURCE_EXHAUSTED`	RPM、TPM、RPD、または支出額に基づく制限に到達した	バックオフを入れて再試行する、リクエストサイズを減らす、または上位ティアへ移行する
モデルが見つからない、または利用できない	無料枠の対象外のモデルを使っている（例：Gemini 4 Argon）	請求先を紐づけるか、無料枠のモデルを選ぶ

プロバイダーをまたいだエラー処理のパターンは、LLMゲートウェイのエラー分類をご覧ください。

Gemini APIキーの本番運用チェックリスト

ノートブックでキーが動いても、そのままユーザー向けに公開できるわけではありません。リリース前に次の項目を確認してください。

キーはサーバー側に置く。 Webアプリやモバイルアプリに埋め込んで配布しないでください。Googleは、クライアントコード内のキーは抽出可能だと説明しています。クライアントとGeminiの間に小さなバックエンドプロキシを設けましょう。
環境ごと、アプリごとにキーを分ける。 開発・ステージング・本番のキーを分け、1つを失効させても他の環境が止まらないようにします。用途がわかる名前を付けてください。
シークレット管理サービスに保存する。 Googleは本番環境でのSecret Managerの利用を推奨しています。キーは実行時に読み込みます。
API制限を設定し、可能ならIP制限も追加する。 認可キーはデフォルトでGemini専用です。固定のバックエンドにはIP制限も追加してください。
サービスアカウントの権限を最小限にする。 紐づけられたサービスアカウントに、不要な広範囲のロールを付与しないでください。
請求アラートを有効にする。 Google Cloudコンソールで設定し、請求書が届く前に利用額の急増を把握できるようにします。
モデルIDを固定する。 設定にはgemini-3.8-flashなどの正確なIDを使い、2026年12月1日と2027年1月1日の料金変更に備えます。
ユーザーデータには有料枠を使う。 無料枠のコンテンツはGoogleのプロダクト改善に使われる可能性があります。
レート制限への対処を設計する。 429には指数バックオフを実装し、上限到達時にキューへ入れる、小さいモデルへ切り替える、フェイルオーバーするなどの動作を決めておきます。
リポジトリ内のキー漏洩をスキャンする。 GitHubのシークレットスキャンとプッシュ保護を有効にします。
定期的にローテーションする。 新しいキーを作成し、デプロイして動作確認を済ませてから、古いキーを無効にします。

より詳しく確認するには、Gemini APIの本番運用準備チェックリストとAPIキーの安全な管理ガイドをご活用ください。

GeminiキーよりFlatkeyのキー1つで運用するほうがシンプルな場合

アプリからClaude、GPT、DeepSeek、Qwenも呼び出す場合、プロバイダーごとにキー、請求先アカウント、レート制限のティアを管理する手間が増えます。Flatkeyなら、Geminiや他のモデルを1つのOpenAI互換キーとベースURL（https://router.flatkey.ai/v1）で利用でき、キーごとの使用ログも確認できます（Flatkeyのドキュメント）。料金面のトレードオフはモデルによって異なるため、正確に比較する必要があります。2026年10月27日時点のFlatkeyのモデルページには、次の料金が記載されていました。

モデル	Googleの定価（標準）	Flatkey
Gemini 4 Argon	$2.00 / $10.00	$1.60 / $8.00
Gemini 3.5 Flash-Lite	$0.30 / $2.50	$0.24 / $2.00
Gemini 3.8 Flash	$0.75 / $3.75（2026年12月31日までのキャンペーン料金）	$1.20 / $6.00

Gemini 3.8 Flashは、2026年12月31日までGoogleのキャンペーン料金がFlatkeyより安いため、それまではFlash専用アプリからGoogleを直接呼び出すほうが低コストです。Flatkeyは、Argon、Flash-Lite、または複数プロバイダーを併用するアプリに、より適しています。

from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["FLATKEY_API_KEY"], base_url="https://router.flatkey.ai/v1")
resp = client.chat.completions.create(
    model="gemini-4-argon",
    messages=[{"role": "user", "content": "Summarize this stack trace in one line."}],
)
print(resp.choices[0].message.content)

よくある質問

Google Gemini APIキーを取得するには？

aistudio.google.com/apikeyにログインして利用規約に同意し、Google Cloudプロジェクトを選択またはインポートして、「APIキーを作成」をクリックします。新規ユーザーにはデフォルトのプロジェクトとキーが自動で作成されます。キーはAI StudioのAPIキーのページに表示されます。

Gemini APIキーは無料？

はい。キーの作成は無料で、Gemini 3.8 FlashやGemini 3.5 Flash-Liteなどのモデルには、レート制限付きの無料枠があります。無料枠のコンテンツはGoogleのプロダクト改善に使われる可能性があります。Gemini 4 Argonは無料では利用できません。

Gemini APIを無料で使うには？

請求先を紐づけずにキーを作成し、gemini-3.8-flashなどの無料枠モデルを、AI Studioに表示される制限内で呼び出します。制限はプロジェクト単位なので、同じプロジェクト内でキーを追加してもクォータは増えません。

Google APIキーはどこで確認できる？

Google AI Studioのダッシュボード → APIキーで確認できます。Gemini以外のGoogle APIに制限されているキーは、Google Cloudコンソールの認証情報ページにのみ表示されます。

APIキーを第三者に知られると何が起きる？

あなたのプロジェクトに課金されるリクエストを送信されたり、クォータを使い切られたりするおそれがあります。認可キーの場合は、紐づけられたサービスアカウントとして操作される可能性もあります。漏洩が疑われる場合は、キーを再作成し、新しいキーをデプロイして古いキーを無効にしたうえで、使用状況を確認してください。

古いGemini APIキーが使えなくなったのはなぜ？

2026年から、Gemini APIは制限のない標準キーを拒否しています。また、2026年5月7日以降は、長期間使われていない、制限のないキーもブロックしています。キーをGemini APIのみに制限するか、新しい認可キーを作成してください。

Gemini APIキーはOpenAI SDKで使える？

はい。ベースURLをhttps://generativelanguage.googleapis.com/v1beta/openai/に設定し、APIキーとしてGeminiキーを渡してください。

まとめ

GeminiキーはAI Studioで2分あれば取得できますが、安全に運用するにはもう少し準備が必要です。認可キーを使い、サーバー側のシークレット管理サービスに保存し、制限と請求アラートを設定してください。実際のユーザーデータには有料枠を使い、予定されている料金変更にも注意しましょう。複数のプロバイダーを使う場合は、プロバイダーごとのキーを1つのゲートウェイキーにまとめられます。Flatkeyのモデルカタログでモデルを比較し、GeminiとClaudeのルーティングガイドで、それぞれにリクエストを振り分ける場面を確認してください。