Gemini API 金鑰 — 如何取得並搭配 OpenAI SDK 使用

Gemini API 金鑰是一項用於驗證您對 Google Gemini 模型之呼叫的憑證：每個請求都會在 Authorization 標頭中攜帶金鑰，使用量則依 token 計量和計費。取得可用金鑰有兩種方式：官方的 Google AI Studio（提供僅限 Gemini 使用的金鑰），或 Kunavo（使用一把相容 OpenAI 的金鑰，即可連接 Gemini、Claude、GPT，以及影像、影片和音訊模型，且不需要 Google Cloud 專案）。本指南將說明如何透過這兩種方式取得金鑰，以及如何進行第一次呼叫。

選項 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 將 Gemini 放在相容 OpenAI 的 API 後方。單一 sk-kn- 金鑰即可呼叫 Gemini 和所有其他模型，使用單一透過 Stripe 計費的錢包，且完全不需要 Google Cloud 專案。Gemini 的價格約比 Google 官方牌價低 70%——例如 Flash 的輸入價格為每 1M token $0.09，輸出價格為每 1M token $0.75。採隨用隨付模式，最低儲值金額為 $10，餘額永遠不會過期。

1. 在 kunavo.com 上註冊。
2. 儲值 $10——採隨用隨付模式，餘額永遠不會過期。
3. 在 /app/keys建立金鑰。金鑰以 sk-kn- 開頭，且只會顯示一次；請將它儲存在環境變數中。
4. 呼叫時，將 OpenAI SDK 指向 https://api.kunavo.com/v1，並使用 Gemini slug。

快速入門

維持使用官方 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",  # a única linha que muda
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Explique RAG em duas frases."}],
)
print(resp.choices[0].message.content)

金鑰安全性

• 絕不要在用戶端公開金鑰。 瀏覽器和行動裝置套件都是公開的，因此請一律透過您自己的伺服器代理。將金鑰儲存在環境變數中，放在受版本控制的程式碼之外。
• 每個專案或環境使用一把金鑰，如此一來，發生外洩時即可撤銷該金鑰，而不會影響其他部分。
• 定期輪替金鑰。 Kunavo 允許同時啟用多把金鑰，因此輪替可以平順銜接，而不是突然中斷。
• 在儀表板中設定每把金鑰的支出上限，並監控 /app/usage，以便依金鑰區分並偵測意外流量。

常見問題