返回指南
API 金鑰·2026年6月18日·更新於 2026年9月24日·閱讀約 8 分鐘

建立 Google Gemini API 金鑰 — 兩種方式(Google AI Studio 與 Kunavo)

如何建立 Google Gemini API 金鑰 — 官方途徑是 Google AI Studio,另一種是透過 Kunavo 使用單一金鑰,不需 Google Cloud 專案即可同時存取 Claude、GPT、圖像與影片。

Gemini API 金鑰可驗證你對 Google Gemini 模型的呼叫:每個請求都會在 Authorization 標頭中攜帶金鑰,平台也會據此衡量並計算使用量。建立 Gemini API 金鑰有兩種方式——直接透過 Google AI Studio(官方方式),或透過 Kunavo:使用一把 OpenAI 相容金鑰,即可存取 Gemini、Claude、GPT,以及影像/影片模型,完全不需要 Google Cloud 專案。

選項 1 — 建立 Google AI Studio API 金鑰(官方方式)

如果你只會呼叫 Gemini,請直接向 Google 取得金鑰:

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

只要你只需要 Gemini,這就是正確的方式。一旦你也要使用 Claude、GPT,或影像與影片模型,就必須為每個提供者管理不同的金鑰、SDK 與帳單。

選項 2 — 透過 Kunavo 建立 Gemini API 金鑰(推薦用於正式環境)

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 和模型名稱——其他都不用改。

gemini_quickstart.py
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # die einzige Zeile, die sich ändert
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Fasse die Handlung von Dune in zwei Sätzen zusammen."}],
)
print(resp.choices[0].message.content)

Node.js 和 curl 也採用相同模式;各模型的價格與完整計算範例,請參閱 Gemini API 價格指南。

安全保存金鑰

  • 使用環境變數,不要放在原始碼中。 絕不要將金鑰提交到儲存庫;請從環境變數讀取。絕不要將金鑰輸出到瀏覽器或行動裝置套件中——一律透過您自己的伺服器代理。
  • 每個專案或環境使用一把金鑰。 如此一來,若金鑰外洩,您可以撤銷該金鑰,而不會讓其他一切停擺。
  • 定期輪替。 Kunavo 允許多把金鑰同時啟用,因此輪替可以平順重疊,而不是硬切換。
  • 設定每把金鑰的輸出限制。 在控制面板中為每把金鑰設定限制,並在 /app/usage 監控每把金鑰的異常流量。

常見問題

如何建立 Google Gemini API 金鑰?

有兩種方式。官方方式:開啟 aistudio.google.com,以 Google 帳戶登入,點選「Get API key」→「Create API key」;金鑰以 AIza… 開頭,且只會顯示一次。透過 Kunavo:在 kunavo.com 註冊,至少儲值 $10,在 /app/keys 產生金鑰,並將 OpenAI SDK 指向 https://api.kunavo.com/v1。第二種方式不需要 Google Cloud 專案,同一把金鑰還能存取 Claude、GPT,以及影像與影片模型。兩種方式都能在不到五分鐘的時間內完成。

如何在 Google AI Studio 中建立 API 金鑰?

在 Google AI Studio 中:前往 aistudio.google.com,以 Google 帳戶登入,按一下左上角的「Get API key」,接著選擇「Create API key」,並選取現有或新的 Google Cloud 專案。金鑰只會顯示一次——請立即複製並存入環境變數。免費方案有速率限制;若要處理正式環境流量,請將專案連結至 Google Cloud 計費帳戶。

什麼是 Gemini 金鑰?之後要在哪裡找回?

Gemini 金鑰是一串用來驗證對 Google Gemini 模型每次請求,並將費用歸屬至帳戶的字串;它會隨 Authorization 標頭傳送。Google 只會在建立時顯示完整金鑰——之後在 Google AI Studio 中只能看到名稱與建立日期。如果遺失金鑰,請刪除並建立新的;無法還原。Kunavo 也是相同原則:金鑰只會顯示一次,之後在 /app/keys 中只能看到中繼資料與使用量。

為什麼我的 Gemini API 金鑰無法運作?

API_KEY_INVALID 最常見的原因是金鑰複製不完整,或環境變數中包含空格或換行。接下來常見的原因包括:金鑰屬於其他 Google Cloud 專案、專案未啟用 Gemini API,或金鑰已被撤銷。先確認值是否確實以 AIza 開頭。Kunavo 金鑰最常見的原因是餘額已用完——這會回傳 402,而不是 401。完整錯誤清單請參閱無效 Gemini API 金鑰指南。

Gemini API 免費嗎?

Google AI Studio 提供具有低速率限制的免費方案金鑰,足以用於原型開發。正式環境流量則使用付費計費。Kunavo 採用隨用隨付,最低儲值金額為 $10,不需要另外建立 Google Cloud 計費帳戶,而且你的餘額永不過期。

Gemini API 金鑰可以在沒有 Google Cloud 帳戶的情況下使用嗎?

可以。Google AI Studio 金鑰可在沒有 Google Cloud 專案的情況下用於原型開發,但有速率限制;正式環境流量則需要 Google Cloud 計費帳戶。Kunavo 金鑰完全不需要 Google Cloud 專案——你可透過 OpenAI 相容端點呼叫 Gemini,並透過 Stripe 統一計費。

Gemini 金鑰與 Kunavo 金鑰有何差異?

Google 金鑰只能呼叫 Gemini,並透過 Google Cloud 帳戶計費。Kunavo 金鑰可透過 OpenAI 相容 API 呼叫 Gemini、Claude、GPT、影像與影片模型,使用單一 Stripe 餘額,且不需要 Google Cloud 專案。各模型的價格請參閱Gemini API 價格指南。

我應該從哪個 Gemini 模型開始?

日常聊天、擷取與摘要可從 gemini-2-5-flash 開始——速度快且非常便宜。若需要更困難的推理、視覺功能與長上下文分析,請切換至 gemini-3-1-pro。