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

Gemini API 金鑰可驗證你對 Google Gemini 模型的呼叫：每個請求都會在Authorization標頭中攜帶金鑰，平台會透過它衡量並計費使用量。取得Gemini API 金鑰有兩種方式——直接透過 Google AI Studio（官方途徑），或透過 Kunavo：使用 OpenAI 相容金鑰，在不需要任何 Google Cloud 專案的情況下存取 Gemini、Claude、GPT 以及圖片和影片模型。

選項 1——Google AI Studio（官方）

如果你永遠只會呼叫 Gemini，就直接向 Google 取得金鑰：

1. 開啟aistudio.google.com，並使用 Google 帳戶登入。
2. 前往Get API key → Create API key。金鑰會以AIza…開頭，且只會顯示一次。
3. 免費層有速率限制，適合原型開發。正式環境請將金鑰連結至Google Cloud 計費帳戶。

只要你只需要 Gemini，這就是正確途徑。一旦也使用 Claude、GPT 或圖片與影片模型，你就必須為每個提供商管理一組金鑰、一個 SDK 和一張帳單。

選項 2——Kunavo（推薦用於正式環境）

Kunavo 將 Gemini 放在 OpenAI 相容 API 後方。單一sk-kn-金鑰即可透過同一端點存取所有模型——不需要 Google Cloud 專案，Gemini 價格約比 Google 牌價低70 %（每 1M token 為$0.09 / $0.75），使用一個 Stripe 餘額，最低 $10 儲值即可隨用隨付。餘額可共同用於 Gemini、Claude、GPT、圖片與影片，且永不過期。

1. 註冊。在kunavo.com建立 Kunavo 帳戶。
2. 儲值 $10。最低儲值 $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",  # la seule ligne qui change
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Résume l'intrigue de Dune en deux phrases."}],
)
print(resp.choices[0].message.content)

Node.js 和 curl 也採用相同模式；各模型費率與詳細範例請見Gemini API 定價指南。

保護金鑰安全

• 使用環境變數，不要寫入原始碼。絕不要將金鑰提交至儲存庫；請從環境變數讀取。絕不要在瀏覽器或行動裝置套件中公開金鑰——一律透過你自己的伺服器。
• 每個專案或環境使用一把金鑰。如此一來，即使某把金鑰洩漏，也能撤銷而不影響其他部分。
• 定期輪替。Kunavo 允許多把金鑰同時啟用，因此輪替可以平順重疊，而非突然中斷。
• 設定每把金鑰的支出上限。在控制面板中設定每把金鑰的限制，並在/app/usage中監控各金鑰的異常流量。

常見問題