Gemini API 密钥——如何获取并与 OpenAI SDK 一起使用

Gemini API 密钥是用于验证你对 Google Gemini 模型调用的凭据：每个请求都会在 Authorization 请求头中携带密钥，使用量按 token 计量并计费。获取可用密钥有两种途径：Google AI Studio（官方途径），提供仅用于 Gemini 的专用密钥；或 Kunavo，通过一个兼容 OpenAI 的密钥调用 Gemini、Claude、GPT 以及图像、视频和音频模型，无需 Google Cloud 项目。本指南介绍如何通过两种途径获取密钥，以及如何进行第一次调用。

选项 1 — Google AI Studio（官方）

如果你只会调用 Gemini，这是正确的方式。

1. 使用 Google 账号登录 aistudio.google.com。
2. 打开 Get API key → Create API key。密钥格式为 AIza...。
3. 免费层级有限，适合原型开发。对于生产环境的用量，需要将密钥关联到一个已启用结算账户的 Google Cloud 项目。

如果你还使用 Claude、图像或视频模型，就需要分别管理每个供应商的一把密钥、一个 SDK 和一张账单。

选项 2 — Kunavo（推荐用于生产环境）

Kunavo 将 Gemini 放在兼容 OpenAI 的 API 后面。一个 sk-kn- 密钥即可调用 Gemini 和所有其他模型，通过 Stripe 使用一个统一余额结算，并且无需任何 Google Cloud 项目。Gemini 的价格约比 Google 列表价低 70%，例如 Flash 的输入价格为每 1M 个 token $0.09，输出价格为每 1M 个 token $0.75。采用按量付费模式，最低充值 $10即可开始，余额永不过期。

1. 在 kunavo.com 上注册。
2. 充值 $10 — 按量付费，余额永不过期。
3. 在 /app/keys 中创建密钥。密钥以 sk-kn- 开头，仅显示一次；请将其保存到环境变量中。
4. 将 OpenAI SDK 指向 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",  # a única linha que muda
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Explique RAG em duas frases."}],
)
print(resp.choices[0].message.content)

密钥安全

• 绝不要在客户端暴露密钥。 浏览器和移动端 bundle 都是公开的 — 始终通过你自己的服务器进行代理。将密钥保存在环境变量中，不要放入版本控制的代码。
• 每个项目或环境使用一把密钥，这样发生泄露时可以撤销该密钥，而不会影响其他部分。
• 定期轮换密钥。 Kunavo 允许同时使用多把活动密钥，因此轮换可以平滑重叠，而不是突然中断。
• 在控制台中为每把密钥设置支出上限，并监控 /app/usage，按密钥细分，以发现意外流量。

常见问题