Gemini を OpenAI SDK で使えますか？

はい。Kunavo は OpenAI 互換の /v1/chat/completions エンドポイントの背後に Gemini を公開しているため、公式の OpenAI SDK をそのまま使い、base_url を https://api.kunavo.com/v1 に変え、model を gemini-2-5-flash のような Gemini スラッグにするだけです。

Gemini API キーの取得方法 — Google AI Studio と Kunavo の 2 つの方法

Q: Gemini API は無料ですか？

Google AI Studio は、レート制限付きの無料枠付きキーを発行します。プロトタイピングには十分ですが、本番のトラフィックは有料の課金に移行します。Kunavo は最低 $5 のチャージから始める従量課金で、Google Cloud の請求先アカウントは不要、残高は失効しません。

Q: Google Cloud アカウントなしで Gemini API キーを取得できますか？

はい。Kunavo の sk-kunavo- キーは、OpenAI 互換エンドポイントの背後で Gemini に到達するため、Google Cloud プロジェクトは不要です。登録して残高をチャージし、キーを作成すればすぐに Gemini を呼び出せます。

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 とモデル名だけです。

gemini_quickstart.py

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% 安く使えます。