ドキュメント
Gemini API キー
OpenAI 互換エンドポイント経由で Gemini Pro および Flash モデルを呼び出すための Gemini API キーの取得方法。Google AI Studio への直接接続と、Claude、GPT-Image、Veo、Suno にもアクセスできる Kunavo の 1 つのキーを使う方法を解説します。
Gemini API キーは、Google の Gemini モデルへのリクエストを認証するためのベアラー認証情報です。Google AI Studio から直接取得する方法と、他のすべてのサービスですでに使用している OpenAI 互換 API 経由で Gemini にアクセスできる単一の sk-kn- キーを使う方法があります。
/app/keys でキーを作成し、base_url=https://api.kunavo.com/v1 を設定してから model="gemini-2-5-flash" を呼び出します。Google Cloud プロジェクトは不要で、同じキーを Claude、GPT-Image、Veo にも使用できます。Gemini API キーとは
Gemini API キーは、Google の Gemini ファミリーへのリクエストを認証するベアラー認証情報です。各リクエストでは Authorization ヘッダーにキーを含めます。プラットフォームはキーに対する使用量を計測し、トークン単位で請求します。現在 Kunavo では、gemini-3-1-pro と gemini-2-5-flash が該当し、OpenAI 互換エンドポイント経由で呼び出せます。
利用したいのが Gemini のみか、Gemini と他の最先端モデルかに応じて、有効なキーを取得する方法は 2 つあります。
方法 A — Google AI Studio から直接キーを取得
aistudio.google.comにアクセスし、Google アカウントでログインします。- API キーを取得 → API キーを作成 を開きます。キーは
AIza...の形式です。 - 本番環境で大量に利用する場合は、請求を有効にした Google Cloud プロジェクトにキーを関連付けてください。
Gemini だけを利用する場合は、この方法が適しています。Claude、画像モデル、動画モデルも利用する場合は、プロバイダーごとに別のキー、SDK、請求書を管理することになります。
方法 B — Gemini とその他すべてに使える Kunavo の 1 つのキー
Kunavo は独立した OpenAI 互換の AI API ゲートウェイです。1つの API キーと従量課金残高で、Claude、GPT、画像、動画、音声の各モデルを利用でき、プロバイダーごとのアカウントは必要ありません。
Kunavo は OpenAI 互換 API を通じて Gemini を提供します。1 つの sk-kn- キーで Gemini と他のすべてのモデルにアクセスでき、Stripe 経由でまとめて請求される残高を使います。
| Google AI Studio キー | Kunavo キー | |
|---|---|---|
| モデル | Gemini のみ | Gemini + Claude、GPT-Image、Veo、Suno |
| エンドポイント | Google GenAI API | https://api. |
| 料金 | Google Cloud アカウント | Stripe の単一ウォレット |
| 利用開始に必要な最低額 | 無料枠(レート制限あり) | $10 のチャージ。有効期限なし |
| キー形式 | AIza... | sk-kn-... |
- Kunavo アカウントを作成し、$10 をチャージします。従量課金で、残高に有効期限はありません。
/app/keysでキーを生成します。キーは一度だけ表示されるため、環境変数に保存してください。- OpenAI SDK の接続先を
https://api.kunavo.com/v1に設定し、Gemini のスラッグを指定して呼び出します。
Python で 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", # the only line that changes
)
resp = client.chat.completions.create(
model="gemini-2-5-flash",
messages=[{"role": "user", "content": "Summarize the plot of Dune in two sentences."}],
)
print(resp.choices[0].message.content)Node.js で Gemini を呼び出す
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.KUNAVO_API_KEY,
baseURL: "https://api.kunavo.com/v1",
});
const resp = await client.chat.completions.create({
model: "gemini-2-5-flash",
messages: [{ role: "user", content: "Summarize the plot of Dune in two sentences." }],
});
console.log(resp.choices[0].message.content);baseURL、Python で base_url を使います。どちらも同じエンドポイントを参照します。または curl で呼び出す
curl https://api.kunavo.com/v1/chat/completions \
-H "Authorization: Bearer $KUNAVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-2-5-flash",
"messages": [{"role": "user", "content": "Hello, Gemini"}]
}'使用する Gemini モデル
- gemini-2-5-flash — チャット、情報抽出、要約に適した高速かつ非常に低価格な標準モデル。
- gemini-3-1-pro — より高度な推論、画像認識、長文コンテキストの分析に適しています。
セキュリティチェックリスト
- キーをクライアント側で公開しないでください。 ブラウザーやモバイルのバンドルは公開されます。必ず独自のサーバー経由でプロキシしてください。
- プロジェクトまたは環境ごとにキーを 1 つ使用してください。 キーが漏洩しても、他のすべてに影響を与えずに失効できます。
- 四半期ごとにローテーションしてください。 Kunavo では複数のキーを同時に有効にできるため、ローテーションを中断なく行えます。
- キー別に分類した予期しないトラフィックがないか、
/app/usageを確認してください。
よくある質問
Gemini API キーは無料ですか?
Google AI Studio では、レート制限の低い無料枠のキーが発行され、プロトタイプ作成に適しています。本番環境のトラフィックでは有料プランに移行します。Kunavo では、Google Cloud の別途請求アカウントを用意せずに、最低 $10 のチャージから従量課金で利用でき、残高に有効期限はありません。
OpenAI SDK で Gemini を使えますか?
はい。Kunavo は Gemini を OpenAI 互換の /v1/chat/completions エンドポイント経由で提供するため、公式 OpenAI SDK をそのまま使い、base_url を https://api.kunavo.com/v1 に変更して、gemini-2-5-flash のような Gemini のスラッグをモデル名に設定するだけです。
Google Gemini API キーと Kunavo API キーの違いは何ですか?
Google のキーでは Gemini のみを呼び出せ、料金は Google Cloud アカウント経由で請求されます。Kunavo のキーでは、OpenAI 互換 API を通じて Gemini、Claude、GPT-Image、Veo、Suno を呼び出せ、Stripe 経由でまとめて請求されます。
最初に使う Gemini モデルはどれですか?
日常的なチャット、情報抽出、要約には、まず gemini-2-5-flash をお試しください。高速で非常に低価格です。より難しい推論、画像認識、長文コンテキストの分析には gemini-3-1-pro をお使いください。