Gemini APIキーの発行方法 — Google AI StudioとKunavoの比較

Gemini APIキーは、GoogleのGeminiモデル呼び出しを認証するベアラー資格情報です。キーを取得する方法は2つあります。Google AI Studioで公式キーを取得するか、KunavoでGemini、Claude、GPT、画像/動画まで1つのOpenAI互換キーで呼び出します（Google Cloudプロジェクト不要）。このガイドでは、2つの経路を比較し、プロダクションで直ちに呼び出しを始める最短の方法を示します。

方法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はGeminiをOpenAI互換エンドポイントの背後に配置します。1つのsk-kn-キーで全モデルを呼び出し、1つのStripe残高で支払うため、Google Cloudプロジェクトは必要ありません。GeminiはGoogleの定価より約70%安く、残高に有効期限はなく、最低$10のチャージから使った分だけ支払います。

1. 登録 — kunavo.comでアカウントを作成します。
2. $10をチャージ — 使った分だけ支払い、残高に有効期限はありません。
3. キーを作成 — /app/keysでキーを作成します。sk-kn-で始まり、一度しか表示されないため、環境変数に保存してください。
4. 呼び出し — OpenAI SDKのbase_urlをhttps://api.kunavo.com/v1に指定し、Geminiスラッグを呼び出します。

クイックスタート

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

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # 바뀌는 건 이 줄뿐입니다
)

# 모델 슬러그만 바꾸면 Claude, GPT 등 다른 모델도 같은 키로 호출됩니다
resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "두 문장으로 자기소개를 해줘."}],
)
print(resp.choices[0].message.content)

キーを安全に管理する

• 環境変数を使用してください。キーをコードにハードコードせず、KUNAVO_API_KEYのような環境変数に保管します。ブラウザーやモバイルバンドルは公開されるため、キーをクライアントに決して公開せず、常に自分のサーバーを経由してプロキシしてください。
• 定期的にローテーションしてください。Kunavoは複数の有効なキーを許可しているため、急激な切り替えではなく、きれいな重複期間を設けて交換できます。四半期ごとのローテーションを推奨します。
• キーごとに支出上限を設定してください。ダッシュボードで各キーの支出上限を指定し、/app/usageでキーごとの利用量を確認すれば、キーが漏えいしても他のキーに影響を与えずに破棄できます。

よくある質問