Gemini API キーは、Google's の Gemini モデルへの呼び出しを認証する ベアラー認証情報です。取得方法は 2 つあります——Google AI Studio(公式)から取得するか、 Kunavo の 1 つの OpenAI 互換キーで Gemini・Claude・GPT・ 画像/動画をまとめて呼び出すか(Google Cloud プロジェクトは不要)です。 このガイドでは両方の手順と、本番でどちらを選ぶべきかを解説します。
方法1 — Google AI Studio(公式)
Gemini だけを使うなら、Google から直接キーを取得するのが王道です。
aistudio.google.comに Google アカウントでログインします。- API キーを取得 → API キーを作成 を開きます。 キーは
AIza...のような形式です。 - プロトタイプ用にはレート制限付きの無料枠が使えます。本番の処理量では、 請求を有効にした Google Cloud のプロジェクトにキーを紐付ける必要があります。
呼び出すモデルが Gemini だけなら、これが正しい道です。ただし Claude や 画像・動画モデルも併用するなら、プロバイダーごとに別々のキー・SDK・ 請求書を管理することになります。
方法2 — Kunavo(本番におすすめ)
Kunavo は OpenAI 互換 API の背後に Gemini を配置しています。1 つの sk-kunavo- キーで Gemini とそのほかすべてのモデルに到達でき、 Google Cloud プロジェクトは不要、決済は Stripe の 1 つの残高にまとまります。 Gemini は Google's の定価より約 70% 安く、$5 から従量課金で始められます。
- 登録 — kunavo.com でアカウントを作成します。
- $5 チャージ — 従量課金で、残高は失効しません。
- キー作成 —
/app/keysでキーを作成します。sk-kunavo-で始まり、表示は一度きりなので環境変数に保存します。 - 呼び出し — OpenAI SDK の
base_urlをhttps://api.kunavo.com/v1に向け、Gemini スラッグを指定します。
どちらの方式がよいかは Gemini API キーのドキュメント にある比較表でも確認できます。料金の内訳は Gemini API 料金ガイド を参照してください。
クイックスタート
公式の 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", # 変更するのはこの 1 行だけ
)
resp = client.chat.completions.create(
model="gemini-2-5-flash", # Gemini モデルのスラッグを指定
messages=[{"role": "user", "content": "Gemini を一文で説明して。"}],
)
print(resp.choices[0].message.content)キーの安全な管理
- 環境変数を使う。 キーをコードに直接書かず、
KUNAVO_API_KEYのような環境変数から読み込みます。 ブラウザやモバイルのバンドルは公開されるため、クライアント側に キーを露出させず、必ず自分のサーバー経由でプロキシします。 - 定期的にローテーションする。 Kunavo は複数の有効な キーを同時に持てるため、ローテーションはハードな切り替えではなく きれいなオーバーラップで行えます。四半期ごとを目安にします。
- キーごとに上限を設ける。 ダッシュボードでキーごとに 上限を設定し、プロジェクトや環境ごとにキーを分ければ、漏洩しても 全体を止めずにそのキーだけ失効できます。
/app/usageで キー別のトラフィックを監視しましょう。
よくある質問
Gemini API は無料ですか?
Google AI Studio はレート制限付きの無料枠付きキーを発行し、プロトタイ ピングには十分です。本番のトラフィックは有料の課金に移行します。 Kunavo は最低 $5 のチャージから始める従量課金で、Google Cloud の請求先 アカウントは不要、残高は失効しません。
Google Cloud アカウントなしでキーを取得できますか?
はい。Kunavo の sk-kunavo- キーは OpenAI 互換エンドポイントの 背後で Gemini に到達するため、Google Cloud プロジェクトは不要です。 登録して残高をチャージし、キーを作成すればすぐに呼び出せます。
Gemini キー vs Kunavo キー?
Google のキーは Gemini のみを呼び出し、Google Cloud アカウントで課金され ます。Kunavo のキーは 1 つの OpenAI 互換 API で Gemini に加えて Claude・ GPT・画像/動画にも到達し、Stripe で一括課金されます。Gemini は Google's の定価より約 70% 安く使えます。