Gemini APIキー — OpenAI SDKで取得して使う方法

Gemini APIキーは、GoogleのGeminiモデルへの呼び出しを認証する資格情報です。各リクエストではヘッダーAuthorizationにキーを含め、利用量は測定され、トークン単位で課金されます。利用可能なキーを取得する方法は2つあります。公式のGoogle AI StudioではGemini専用キーが発行され、Kunavoでは、Google Cloudプロジェクトなしで、1つのOpenAI互換キーでGemini、Claude、GPT、画像・動画・音声モデルを利用できます。このガイドでは、両方の方法でキーを取得する方法と、最初の呼び出しを行う方法を説明します。

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

Geminiだけを呼び出す場合は、これが適切な方法です。

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

Claude、画像、動画も使用する場合、この方法ではプロバイダーごとに別のキー、SDK、請求を管理することになります。

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

Kunavoは、OpenAI互換APIの背後でGeminiを提供します。1つのキーsk-kn-でGeminiを含むすべてのモデルを呼び出せ、Stripe経由で課金されるウォレットも1つだけです。さらにGoogle Cloudプロジェクトは一切不要です。GeminiはGoogleの定価より約70%安く、たとえばFlashは入力100万トークンあたり$0.09、出力100万トークンあたり$0.75です。最低$10の入金から始める従量課金制で、残高に有効期限はありません。

1. kunavo.comで登録します。
2. $10を入金します — 従量課金制で、残高に有効期限はありません。
3. キーを作成します（/app/keys）。キーはsk-kn-で始まり、一度しか表示されないため、環境変数に保存してください。
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",  # a única linha que muda
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Explique RAG em duas frases."}],
)
print(resp.choices[0].message.content)

キーのセキュリティ

• キーをクライアントに絶対に公開しないでください。ブラウザやモバイルのバンドルは公開されます。必ず自身のサーバー経由でプロキシしてください。キーは環境変数に保存し、バージョン管理対象のコードの外に置きます。
• プロジェクトまたは環境ごとにキーを分けてください。そうすれば、漏えい時に他の環境を停止せず、そのキーだけを無効化できます。
• 定期的にローテーションしてください。Kunavoでは複数のキーを同時に有効化できるため、ローテーションは突然の停止ではなく、スムーズな重複切り替えになります。
• ダッシュボードでキーごとの支出上限を設定し、/app/usageをキー別に監視して予期しないトラフィックを検出します。

よくある質問