Gemini API キーを取得する

Gemini API を使用するには、API キーが必要です。鍵は Google AI Studio で数回のクリックで作成できます。

API キーを設定する

最初のテストでは、API キーをハードコードできますが、安全ではないため、一時的なものにする必要があります。このセクションの残りの部分では、さまざまなオペレーティングシステムで環境変数としてローカルに API キーを設定する方法について説明します。

Linux/macOS - Bash

Bash は、Linux と macOS の一般的なターミナル構成です。構成ファイルがあるかどうかを確認するには、次のコマンドを実行します。

~/.bashrc

レスポンスが「No such file or directory」の場合は、このファイルを作成して次のコマンドを実行するか、zsh を使用して開く必要があります。

touch ~/.bashrc
open ~/.bashrc

次に、次のエクスポートコマンドを追加して API キーを設定する必要があります。

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

ファイルを保存したら、次のコマンドを実行して変更を適用します。

source ~/.bashrc

macOS - Zsh

Zsh は、Linux と macOS の一般的なターミナル構成です。構成ファイルがあるかどうかを確認するには、次のコマンドを実行します。

~/.zshrc

レスポンスが「No such file or directory」の場合は、次のコマンドを実行してこのファイルを作成して開くか、bash を使用する必要があります。

touch ~/.zshrc
open ~/.zshrc

次に、次のエクスポートコマンドを追加して API キーを設定する必要があります。

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

ファイルを保存したら、次のコマンドを実行して変更を適用します。

source ~/.zshrc

Windows

システム設定で [環境変数] を検索する
[ユーザー変数]（現在のユーザー用）または [システム変数]（すべてのユーザー用 - 慎重に使用）を編集します。
変数を作成し、export GEMINI_API_KEY=your_key_here を追加します。
変更を適用する

最初の Gemini API リクエストを送信する

curl コマンドを使用して設定を確認できます。

  curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=${GEMINI_API_KEY}" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }'

API キーを安全に保管する

Gemini API キーは安全に保管してください。Gemini API キーを使用する際は、次の点にご留意ください。

Google AI Gemini API は、認可に API キーを使用します。他のユーザーが Gemini API キーにアクセスすると、そのユーザーはプロジェクトの割り当てを使用して呼び出しを行うことができます。これにより、チューニング済みモデルとファイルにアクセスするだけでなく、割り当ての損失や課金対象プロジェクトの追加料金が発生する可能性があります。
API キーの制限を追加すると、各 API キーで使用できるサーフェス領域を制限できます。
Gemini API キーの安全はお客様の責任で確保してください。
- Gemini API キーをソース管理にチェックインしないでください。
- クライアントサイドアプリケーション（Android、Swift、ウェブ、Dart/Flutter）では、API キーが漏洩するリスクがあります。本番環境アプリで Google AI クライアント SDK を使用して、モバイルアプリやウェブアプリから Google AI Gemini API を直接呼び出すことはおすすめしません。

一般的なベストプラクティスについては、こちらのサポート記事もご覧ください。