Gemini APIキー — 取得方法とOpenAI SDKでの使用方法

Gemini APIキーは、GoogleのGeminiモデルへの呼び出しを認証します。各リクエストにキーをAuthorizationヘッダーで含め、プラットフォームはそのキーを通じて使用量を計測・課金します。Gemini APIキーを取得する方法は2つあります。Google AI Studioから直接取得する公式の方法と、Kunavo経由で取得する方法です。後者は、Google CloudプロジェクトなしでGemini、Claude、GPT、画像・動画モデルにアクセスできるOpenAI互換キーです。

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

Geminiだけを今後ずっと呼び出すなら、キーをGoogleから直接取得してください。

1. aistudio.google.comを開き、Googleアカウントでログインします。
2. Get API key → Create API keyに移動します。キーはAIza…で始まり、1回しか表示されません。
3. 無料枠にはレート制限があり、プロトタイプ作成に適しています。本番環境ではキーをGoogle Cloudの請求アカウントに関連付けてください。

Geminiだけが必要な間は、これが適切な方法です。Claude、GPT、画像・動画モデルも使い始めると、プロバイダーごとにキー、SDK、請求書を管理することになります。

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

KunavoはGeminiをOpenAI互換APIの背後に配置します。1つのsk-kn-キーで、同じエンドポイント上のすべてのモデルにアクセスできます。Google Cloudプロジェクトは不要で、GeminiはGoogleの定価より約70%安価（トークン100万個あたり$0.09 / $0.75）、Stripe残高による従量課金は$10のチャージから利用できます。残高はGemini、Claude、GPT、画像、動画をまとめてカバーし、有効期限はありません。

1. 登録する。kunavo.comでKunavoアカウントを作成します。
2. $10をチャージする。最低$10のチャージから従量課金で利用でき、残高に有効期限はありません。
3. キーを作成する。/app/keysでキーを生成します。キーはsk-kn-で始まり、1回しか表示されないため、環境変数に保存してください。
4. 呼び出す。OpenAI SDKを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",  # la seule ligne qui change
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Résume l'intrigue de Dune en deux phrases."}],
)
print(resp.choices[0].message.content)

同じパターンはNode.jsとcurlにも適用できます。モデル別料金と詳細な例については、Gemini API料金ガイドをご覧ください。

キーを安全に保管する

• ソースコードではなく環境変数を使う。キーをリポジトリにコミットしないでください。環境変数から読み込みます。ブラウザやモバイルのバンドルにキーを露出させず、必ずご自身のサーバーを経由してください。
• プロジェクトまたは環境ごとに1つのキーを使う。キーが漏えいした場合は、他のものを壊さずにそのキーだけを失効できます。
• 定期的なローテーション。 Kunavoでは複数のキーをアクティブにできるため、ローテーションは突然の切断ではなく、適切な重複期間を設けて行えます。
• キーごとの支出上限。 ダッシュボードでキーごとの上限を設定し、/app/usageでキー別の予期しないトラフィックを監視します。

よくある質問