Gemini API キーを使用する

Gemini API を使用するには、リクエストを認証する必要があります。認証には、標準 API キーまたは認可 API キーを使用できます。

Gemini API キーを作成または表示する

API キーの種類: 標準と認可

API キーを使用すると Gemini API にアクセスできますが、セキュリティ特性は異なります。セキュリティを強化するため、Gemini API は標準 API キーから認可キーに移行しています。

• 標準 API キー: 課金と割り当てを目的として、リクエストを Google Cloud プロジェクトに関連付けます。標準キーは呼び出し元を識別しないため、サポートできる権限とアクセス制御の粒度が制限されます。
• 認可（auth）キー: Google Cloud サービス アカウントに直接バインドされます。認可キーを使用すると、バインドされたサービス アカウントの ID でリクエストが処理されるため、きめ細かいアクセス制御が可能になります。認可キーはデフォルトで Generative Language API（Gemini API）に制限されており、システムで検出された漏洩キーの使用を迅速に停止する、漏洩キーの迅速な適用を提供します。

安全な使用を確保するため、Gemini API は標準キーから認可キーに移行します。

• 認可キーがデフォルト: Google AI Studio で作成された新しい API キーはすべて、 認可キーとして自動的に作成されます。
• 制限のないキーは拒否される: Gemini API は、リクエストを拒否します 制限のない標準キーから。明示的な制限が適用された標準 API キーは引き続き機能します。この制限により、一般公開されているキーや他のサービスにリンクされているキーの不正使用を防ぐことができます。
• 2026 年 9 月: Gemini API は、標準 キー からのリクエストを拒否します。サービスの停止を回避するため、この日付より前に認可キーに移行する 必要があります。2026 年 9 月までに認可キーに移行してください。

Google AI Studio で API キーを管理する

プロジェクトとキーは Google AI Studio で直接管理できます。

Google Cloud プロジェクト

すべての Gemini API キーは Google Cloud プロジェクト に関連付けられています。 Google Cloud プロジェクトは、課金、共同編集者、権限を管理します。Google AI Studio には、これらのプロジェクトにアクセスするための軽量インターフェースが用意されています。

• デフォルト プロジェクト: 新規ユーザーの場合、利用規約に同意すると、Google AI Studio によってデフォルトの Google Cloud プロジェクトと API キーが自動的に 作成されます。このプロジェクトの名前を変更するには、ダッシュボードの [Projects] ビューに移動します。
• 既存のプロジェクト: Google Cloud アカウントをすでにお持ちの場合、AI Studio はデフォルト プロジェクトを作成しません。代わりに、既存のプロジェクトをインポートする必要があります。

プロジェクトをインポートする

デフォルトでは、Google AI Studio にはすべての Google Cloud プロジェクトが表示されません。使用するプロジェクトをインポートする必要があります。

1. Google AI Studio に移動します。
2. 左側のパネルから [Dashboard] を開き、[Projects] を選択します。
3. [Import projects] ボタンをクリックします。
4. インポートする Google Cloud プロジェクトを検索して選択し、[Import] をクリックします。
5. インポートしたら、ダッシュボードの [API Keys] ページに移動して、そのプロジェクトにキーを作成します。

キー作成権限のトラブルシューティング

If the [Create API key] button is unavailable and displays the message: "You do not have permission to create a key in this project", you lack the required IAM permissions.

Google Cloud クラウド プロジェクトまたは組織の管理者に、次の権限を含むロール（プロジェクト編集者など）の付与を依頼してください。

• resourcemanager.projects.get: AI Studio がプロジェクトを検証できるようにします。
• apikeys.keys.create: キーの生成を許可します。
• serviceusage.services.enable: Generative Language API が有効になっていることを確認します。
• iam.serviceAccounts.create: リンクされたサービス アカウントを作成するために必要です。
• iam.serviceAccountApiKeyBindings.create: サービス アカウントを API キーにバインドします。

管理アクセス権を取得できない場合は、組織に関連付けられていない新しい Google Cloud プロジェクトを作成して、キーを生成できます。

環境設定

キーを取得したら、アプリケーションで安全に使用できるように環境を構成します。

方法 1: 環境変数を使用する（推奨）

環境変数 GEMINI_API_KEY または GOOGLE_API_KEY を設定します。Gemini API クライアント ライブラリは、これらの変数を自動的に検出して使用します。両方が設定されている場合は、GOOGLE_API_KEY が優先されます。

オペレーティング システムを選択して変数を設定します。

~/.bashrc

touch ~/.bashrc && open ~/.bashrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.bashrc

~/.zshrc

touch ~/.zshrc && open ~/.zshrc