ドキュメント

ドキュメント

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 から直接キーを取得

  1. aistudio.google.com にアクセスし、Google アカウントでログインします。
  2. API キーを取得 → API キーを作成 を開きます。キーは AIza... の形式です。
  3. 本番環境で大量に利用する場合は、請求を有効にした 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 APIhttps://api.kunavo.com/v1
料金Google Cloud アカウントStripe の単一ウォレット
利用開始に必要な最低額無料枠(レート制限あり)$10 のチャージ。有効期限なし
キー形式AIza...sk-kn-...
  1. Kunavo アカウントを作成し、$10 をチャージします。従量課金で、残高に有効期限はありません。
  2. /app/keys でキーを生成します。キーは一度だけ表示されるため、環境変数に保存してください。
  3. 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);
OpenAI SDK では、Node で 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 — より高度な推論、画像認識、長文コンテキストの分析に適しています。
モデルごとの料金やコスト計算例については、Gemini API 料金ガイドと料金ページをご覧ください。

セキュリティチェックリスト

  • キーをクライアント側で公開しないでください。 ブラウザーやモバイルのバンドルは公開されます。必ず独自のサーバー経由でプロキシしてください。
  • プロジェクトまたは環境ごとにキーを 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 をお使いください。

次に確認する項目