Gemini API を使用するには、API キーが必要です。Google AI Studio で数回クリックするだけで、キーを無料で作成できます。
API キーを取得したら、次の方法で Gemini API に接続できます。
最初のテストでは、API キーをハードコードできますが、安全ではないため、一時的なものにする必要があります。API キーをハードコードする例については、API キーを明示的に指定するをご覧ください。
API キーを環境変数として設定する
環境変数 GEMINI_API_KEY または GOOGLE_API_KEY を設定すると、Gemini API ライブラリのいずれかを使用するときに、API キーがクライアントによって自動的に取得されます。これらの変数のいずれか一方のみを設定することをおすすめしますが、両方を設定した場合は、GOOGLE_API_KEY が優先されます。
REST API またはブラウザで JavaScript を使用している場合は、API キーを明示的に指定する必要があります。
さまざまなオペレーティング システムで、API キーをローカル環境変数 GEMINI_API_KEY として設定する方法は次のとおりです。
Linux/macOS - Bash
Bash は、Linux と macOS の一般的なターミナル構成です。構成ファイルがあるかどうかを確認するには、次のコマンドを実行します。
~/.bashrcレスポンスが「No such file or directory」の場合は、このファイルを作成して次のコマンドを実行するか、zsh を使用して開く必要があります。
touch ~/.bashrcopen ~/.bashrc
次に、次のエクスポート コマンドを追加して API キーを設定する必要があります。
export GEMINI_API_KEY=<YOUR_API_KEY_HERE>ファイルを保存したら、次のコマンドを実行して変更を適用します。
source ~/.bashrcmacOS - Zsh
Zsh は、Linux と macOS の一般的なターミナル構成です。構成ファイルがあるかどうかを確認するには、次のコマンドを実行します。
~/.zshrcレスポンスが「No such file or directory」の場合は、このファイルを作成して次のコマンドを実行するか、bash を使用して開く必要があります。
touch ~/.zshrcopen ~/.zshrc
次に、次のエクスポート コマンドを追加して API キーを設定する必要があります。
export GEMINI_API_KEY=<YOUR_API_KEY_HERE>ファイルを保存したら、次のコマンドを実行して変更を適用します。
source ~/.zshrcWindows
- システム設定で [環境変数] を検索する
- [ユーザー変数]（現在のユーザー用）または [システム変数]（すべてのユーザー用 - 慎重に使用）を編集します。
- 変数を作成して
export GEMINI_API_KEY=your_key_hereを追加する - 変更を適用する
API キーを明示的に指定する
場合によっては、API キーを明示的に指定する必要があります。次に例を示します。
- 単純な API 呼び出しを実行していて、API キーをハードコードすることを希望している。
- Gemini API ライブラリによる環境変数の自動検出に依存せずに、明示的に制御したい
- 環境変数がサポートされていない環境（ウェブなど）を使用している、または REST 呼び出しを行っている。
以下に、API キーを明示的に指定する方法の例を示します。
Python
from google import genai
client = genai.Client(api_key="YOUR_API_KEY")
response = client.models.generate_content(
model="gemini-2.5-flash", contents="Explain how AI works in a few words"
)
print(response.text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });
async function main() {
const response = await ai.models.generateContent({
model: "gemini-2.5-flash",
contents: "Explain how AI works in a few words",
});
console.log(response.text);
}
main();
Go
package main
import (
"context"
"fmt"
"log"
"google.golang.org/genai"
)
func main() {
ctx := context.Background()
client, err := genai.NewClient(ctx, &genai.ClientConfig{
APIKey: "YOUR_API_KEY",
Backend: genai.BackendGeminiAPI,
})
if err != nil {
log.Fatal(err)
}
result, err := client.Models.GenerateContent(
ctx,
"gemini-2.5-flash",
genai.Text("Explain how AI works in a few words"),
nil,
)
if err != nil {
log.Fatal(err)
}
fmt.Println(result.Text())
}
Java
package com.example;
import com.google.genai.Client;
import com.google.genai.types.GenerateContentResponse;
public class GenerateTextFromTextInput {
public static void main(String[] args) {
Client client = Client.builder().apiKey("YOUR_API_KEY").build();
GenerateContentResponse response =
client.models.generateContent(
"gemini-2.5-flash",
"Explain how AI works in a few words",
null);
System.out.println(response.text());
}
}
REST
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=$YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
"contents": [
{
"parts": [
{
"text": "Explain how AI works in a few words"
}
]
}
]
}'
API キーを安全に保管する
Gemini API キーは安全に保管してください。Gemini API キーを使用する際は、次の点にご留意ください。
Google AI Gemini API は、認可に API キーを使用します。他のユーザーが Gemini API キーにアクセスすると、そのユーザーはプロジェクトの割り当てを使用して呼び出しを行うことができます。これにより、チューニング済みモデルとファイルにアクセスするだけでなく、割り当ての損失や課金対象プロジェクトの追加料金が発生する可能性があります。
API キー制限を追加すると、各 API キーで使用できるサーフェス領域を制限できます。
Gemini API キーの安全性はお客様の責任で確保してください。
- Gemini API キーをソース管理にチェックインしないでください。
- クライアントサイド アプリケーション（ウェブ、Dart/Flutter）では、API キーが漏洩するリスクがあります。本番環境アプリで Google AI クライアント SDK を使用して、ウェブアプリから Google AI Gemini API を直接呼び出すことはおすすめしません。
一般的なベスト プラクティスについては、こちらのサポート記事もご覧ください。