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. 打开 Get API key → Create API key。密钥格式如 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 年定价
• 浏览完整模型目录