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. Googleアカウントでaistudio.google.comにログインします。
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",  # satu-satunya baris yang berubah
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Jelaskan RAG dalam dua kalimat."}],
)
print(resp.choices[0].message.content)

キーのセキュリティ

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

よくある質問