Gemini API 金鑰

Gemini API 金鑰是用來驗證你對 Google Gemini 模型呼叫的憑證。你可以直接從 Google AI Studio 取得金鑰，也可以使用一組 sk-kn- 金鑰，透過你已用於其他服務的同一個 OpenAI 相容 API 呼叫 Gemini。

Gemini API 金鑰是什麼

Gemini API 金鑰是一種 bearer 憑證，可授權對 Google Gemini 系列發出請求。每個請求都會在 Authorization 標頭中帶上金鑰；平台會依據該金鑰計算使用量，並按 token 計費。目前在 Kunavo 上，這代表可透過 OpenAI 相容端點呼叫 gemini-3-1-pro 和 gemini-2-5-flash。

你可以依照需求選擇兩種方式取得可用金鑰：只使用 Gemini，或讓 Gemini 與其他前沿模型一同使用。

選項 A — 直接從 Google AI Studio 取得金鑰

1. 前往 aistudio.google.com，並使用 Google 帳戶登入。
2. 開啟 取得 API 金鑰 → 建立 API 金鑰。金鑰格式為 AIza...。
3. 若要處理正式環境流量，請將金鑰連結至已啟用帳單的 Google Cloud 專案。

如果你只會呼叫 Gemini，這是合適的選擇。如果你也會使用 Claude、圖像或影片模型，就得為每個供應商分別管理金鑰、SDK 和帳單。

選項 B — 使用一組 Kunavo 金鑰呼叫 Gemini 和其他所有服務

Kunavo 是獨立且相容於 OpenAI 的 AI API 閘道：使用一組 API 金鑰和一筆隨用隨付餘額，即可呼叫 Claude、GPT 以及圖像、影片和音訊模型，無須為各家供應商個別註冊帳戶。

Kunavo 透過 OpenAI 相容 API 提供 Gemini。一組 sk-kn- 金鑰即可呼叫 Gemini 和所有其他模型，並共用一個透過 Stripe 計費的餘額。

1. 建立 Kunavo 帳戶並儲值 $10——採用隨用隨付，餘額永不失效。
2. 在 /app/keys 建立金鑰。金鑰只會顯示一次；請將其儲存在環境變數中。
3. 將 OpenAI SDK 指向 https://api.kunavo.com/v1，並呼叫 Gemini slug。

使用 Python 呼叫 Gemini

繼續使用官方 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",  # the only line that changes
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Summarize the plot of Dune in two sentences."}],
)
print(resp.choices[0].message.content)

使用 Node.js 呼叫 Gemini

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KUNAVO_API_KEY,
  baseURL: "https://api.kunavo.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gemini-2-5-flash",
  messages: [{ role: "user", content: "Summarize the plot of Dune in two sentences." }],
});
console.log(resp.choices[0].message.content);

或使用 curl 呼叫

curl https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2-5-flash",
    "messages": [{"role": "user", "content": "Hello, Gemini"}]
  }'

該使用哪個 Gemini 模型

• gemini-2-5-flash — 速度快、價格極低，是聊天、資料擷取和摘要工作的預設選擇。
• gemini-3-1-pro — 推理、視覺理解和長上下文分析能力更強。

安全性檢查清單

• 絕不要在用戶端公開金鑰。瀏覽器和行動應用程式套件都是公開的——請務必透過自己的伺服器轉送請求。
• 每個專案或環境使用一組金鑰，如此一來，金鑰外洩時就能撤銷該金鑰，而不必影響其他服務。
• 每季輪替一次。Kunavo 允許同時使用多組有效金鑰，因此輪替時可平順重疊，不必硬切換。
• 查看 /app/usage，依金鑰追蹤是否有異常流量。

常見問題

接下來可以查看

• 快速入門 — 60 秒內發出第一個請求
• Gemini API 2026 年定價
• 瀏覽完整模型目錄