Gemini APIキーの取得 — Google AI StudioとKunavoで順番に解説

Gemini APIキーは、GoogleのGeminiモデルへの呼び出しを認証するBearer認証情報です。キーを取得する方法は2つあります。直接Google AI Studioから取得する公式の方法と、Kunavoを利用する方法です。後者では、Google Cloudプロジェクトを設定せずに、Gemini、Claude、GPT、画像・動画を1つのOpenAI互換キーで利用できます。このガイドでは両方の方法を手順ごとに説明し、数分でGeminiを呼び出せるようにします。

オプション1 — Google AI Studio（公式）

Geminiだけを使用する場合は、Googleから直接キーを取得できます。

1. aistudio.google.comにGoogleアカウントでログインします。
2. Get API key → Create API keyの順に進みます。キーはAIza...で始まります。
3. プロトタイピング向けに、レート制限付きの無料枠があります。
4. 本番ボリュームでは、課金が有効なGoogle Cloudプロジェクトにキーを紐付ける必要があります。

Geminiが呼び出す唯一のモデルである場合は、これが適切な方法です。Claude、画像、動画モデルも使用する場合は、プロバイダーごとに別のキー、SDK、請求を管理する必要があります。

オプション2 — Kunavo（本番環境に推奨）

Kunavoは、OpenAI互換APIの背後でGeminiを提供します。1つのsk-kn-キーでGeminiと他のすべてのモデル（OpenAI互換エンドポイント経由）にアクセスでき、Google Cloudプロジェクトは不要です。GeminiはGoogleの定価より約70%安く、1つのStripe残高ですべてをカバーし、$10から従量課金制を利用できます。

1. Kunavoアカウントを作成し、$10を入金します。従量課金制で、残高に有効期限はありません。
2. /app/keysページでキーを作成します。キーは一度しか表示されないため、環境変数に保存してください。
3. OpenAI SDKの送信先をhttps://api.kunavo.com/v1に設定し、Geminiのスラッグを呼び出します。
4. 呼び出し時に、gemini-2-5-flashのような値をモデルフィールドに渡すだけです。

クイックスタート

公式OpenAI SDKはそのまま使用します。変更するのはbase_urlとモデル名だけで、それ以外は変更しません。

import os
from openai import OpenAI

# Resmi OpenAI SDK'sını koruyun; yalnızca base_url ve model değişir.
client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # değişen tek satır
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Merhaba Gemini, kendini bir cümleyle tanıt."}],
)
print(resp.choices[0].message.content)

キーを安全に保つ

• キーをクライアント側に絶対に公開しないでください。ブラウザとモバイルのバンドルは公開されます。必ず自身のサーバー経由でプロキシしてください。キーは.envファイルと環境変数に保存し、ソースコードに埋め込まないでください。
• プロジェクトまたは環境ごとに別のキーを使用してください。そうすれば、漏えい時に他のすべてを停止せず、そのキーだけを無効化できます。
• 定期的にローテーションしてください。Kunavoでは複数のキーを同時に有効化できるため、ローテーションは強制的な停止ではなく、スムーズな移行になります。
• キーごとの支出上限を設定してください。ダッシュボードで各キーに上限を設定し、/app/usageページでキー別に予期しないトラフィックを監視します。

よくある質問