取得 Gemini API 金鑰 — 透過 Google AI Studio 與 Kunavo 的逐步指南

Gemini API 金鑰是用於驗證您對 Google Gemini 模型之呼叫的 bearer 憑證。取得金鑰有兩種方式：直接從Google AI Studio取得（官方方式），或透過Kunavo取得——使用一把相容 OpenAI 的金鑰，即可連接 Gemini、Claude、GPT，以及影像／影片模型，而且不必建立 Google Cloud 專案。本指南將逐步說明這兩種方式，讓您在幾分鐘內呼叫 Gemini。

選項 1 — Google AI Studio（官方）

如果您只打算使用 Gemini，可以直接向 Google 取得金鑰：

1. 使用 Google 帳戶登入 aistudio.google.com。
2. 依序前往 Get API key → Create API key。金鑰以 AIza... 開頭。
3. 提供用於原型開發、速率受限的有限免費方案。
4. 若要用於生產環境，您必須將金鑰連結至已啟用計費功能的 Google Cloud 專案。

如果 Gemini 是您唯一會呼叫的模型，這是正確的做法。但如果您也使用 Claude、影像或影片模型，就必須為每個提供者分別管理金鑰、SDK 和帳單。

選項 2 — Kunavo（建議用於生產環境）

Kunavo 透過相容於 OpenAI 的 API 提供 Gemini。單一 sk-kn- 金鑰即可存取 Gemini 及其他所有模型（透過相容於 OpenAI 的端點）— 不需要 Google Cloud 專案。Gemini 的定價約比 Google 公開定價低 %70，單一 Stripe 餘額涵蓋所有項目，並可從 $10 起採用隨用隨付模式。

1. 建立 Kunavo 帳戶並儲值 $10 — 隨用隨付，餘額永不過期。
2. 在 /app/keys 頁面建立金鑰。金鑰只會顯示一次；請將其儲存在環境變數中。
3. 將 OpenAI SDK 指向 https://api.kunavo.com/v1，並呼叫 Gemini slug。
4. 呼叫即可 — 將模型欄位設為 gemini-2-5-flash 等值，僅此而已。

快速開始

您可以繼續使用官方 OpenAI SDK。只需變更 base_url 和模型名稱 — 其他內容都不要變更：

import os
from openai import OpenAI

# Resmi OpenAI SDK'sını koruyun; yalnızca base_url ve model değişir.
client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # değişen tek satır
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Merhaba Gemini, kendini bir cümleyle tanıt."}],
)
print(resp.choices[0].message.content)

保護您的金鑰

• 切勿在用戶端公開金鑰。瀏覽器和行動套件都是公開的 — 請一律透過您自己的伺服器進行代理。將金鑰存放在 .env 檔案和環境變數中，絕不要嵌入原始碼。
• 每個專案或環境使用不同的金鑰，這樣即使發生外洩，也能撤銷該金鑰而不會停用其他所有項目。
• 定期輪替。 Kunavo 允許同時使用多個有效金鑰，因此輪替可以是平順的重疊切換，而不是硬性中斷。
• 為每個金鑰設定支出上限。您可以在控制面板中為每個金鑰設定上限，並在 /app/usage 頁面按金鑰監控非預期流量。

常見問題