Gemini API key — 如何取得並搭配 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 每 1J 輸入 token 為 $0.09，每 1J 輸出 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",  # 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)

金鑰安全性

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

常見問題