Gemini API 金鑰申請方法 — Google AI Studio 與 Kunavo

Gemini API 金鑰是用於驗證 Google Gemini 模型呼叫的 Bearer 憑證。取得金鑰有兩種方式——在Google AI Studio取得官方金鑰，或在Kunavo使用單一 OpenAI 相容金鑰呼叫 Gemini、Claude、GPT、圖片與影片（不需要 Google Cloud 專案）。本指南比較這兩種路徑，並說明最快開始在正式環境中直接呼叫的方法。

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

如果您計畫只呼叫 Gemini，直接向 Google 取得金鑰是合適的方式。

1. 前往aistudio.google.com，使用 Google 帳戶登入。
2. 選擇Get API key → Create API key以建立金鑰。金鑰格式為AIza...。
3. 用於原型開發的免費等級具有請求限制，適合初期開發。
4. 若要處理正式環境流量，必須將金鑰連結至已啟用付款功能的 Google Cloud 付款帳戶。

如果 Gemini 未來仍是唯一要呼叫的模型，這條路徑很合適。但如果也要使用 Claude 或圖片／影片模型，就必須分別管理各供應商的金鑰、SDK 和帳單。

方法 2——Kunavo（建議用於正式環境）

Kunavo 將 Gemini 置於 OpenAI 相容端點之後。使用單一sk-kn-金鑰呼叫所有模型，並透過單一 Stripe 餘額付款，因此不需要 Google Cloud 專案。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。

快速開始

直接使用官方 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",  # 바뀌는 건 이 줄뿐입니다
)

# 모델 슬러그만 바꾸면 Claude, GPT 등 다른 모델도 같은 키로 호출됩니다
resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "두 문장으로 자기소개를 해줘."}],
)
print(resp.choices[0].message.content)

安全管理金鑰

• 請使用環境變數。不要將金鑰寫死在程式碼中，請存放在類似KUNAVO_API_KEY的環境變數中。瀏覽器或行動裝置套件都會公開，因此絕對不要將金鑰暴露給用戶端，並始終透過自己的伺服器進行代理。
• 定期輪替。Kunavo 允許多個啟用中的金鑰，因此可以透過乾淨的重疊方式輪替，而不必突然切換。建議每季輪替一次。
• 設定每個金鑰的支出上限。在控制面板中為每個金鑰指定支出上限，並在/app/usage查看各金鑰的用量；即使金鑰外洩，也能在不影響其他金鑰的情況下撤銷它。

常見問題