如何取得 Gemini API 金鑰——Google AI Studio 與 Kunavo 的 2 種方法

Gemini API 金鑰是用於驗證對 Google 的 Gemini 模型呼叫的持有人憑證。有兩種取得方式——從Google AI Studio（官方）取得，或使用Kunavo 的單一 OpenAI 相容金鑰，統一呼叫 Gemini、Claude、GPT、圖片與影片模型（不需要 Google Cloud 專案）。本指南將說明兩種方法，以及正式環境應該選擇哪一種。

方法 1——Google AI Studio（官方）

如果只使用 Gemini，直接向 Google 取得金鑰是標準做法。

1. 使用 Google 帳戶登入 aistudio.google.com。
2. 開啟取得 API 金鑰 → 建立 API 金鑰。金鑰格式類似 AIza...。
3. 原型開發可使用附帶速率限制的免費額度。正式環境的處理量則必須將金鑰繫結至已啟用計費功能的 Google Cloud 專案。

如果只呼叫 Gemini，這是正確的途徑。不過如果也要使用 Claude 或圖片、影片模型，就必須分別管理各供應商的金鑰、SDK 與帳單。

方法 2——Kunavo（推薦用於正式環境）

Kunavo 在 OpenAI 相容 API 後提供 Gemini。使用一把 sk-kn- 金鑰即可連線至 Gemini 與其他所有模型，不需要 Google Cloud 專案，付款也會統一到 Stripe 的單一餘額。Gemini 的價格約比 Google 的官方定價低 70%，並可從$10 開始按量計費。

1. 註冊——在 kunavo.com 建立帳戶。
2. 儲值 $10——按量計費，餘額不會過期。
3. 建立金鑰——在 /app/keys 建立金鑰。金鑰以 sk-kn- 開頭，只會顯示一次，因此請儲存至環境變數。
4. 呼叫——將 OpenAI SDK 的 base_url 指向 https://api.kunavo.com/v1，並指定 Gemini slug。

兩種方式的差異也可在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監控各金鑰的流量。

常見問題