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

Gemini API 密钥用于验证您对 Google Gemini 模型的调用：每个请求都会在 Authorization标头中携带该密钥，平台据此统计和计费使用量。获取 Gemini API 密钥有两种方式——直接通过 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. 免费层的速率有限，适合原型开发。用于生产环境时，请将密钥关联到 Google Cloud 计费账户。

只需要 Gemini 时，这是正确的方式。一旦您还使用 Claude、GPT 或图像和视频模型，就需要为每个提供商分别管理密钥、SDK 和账单。

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

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 和模型名称——其他内容无需更改。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # la seule ligne qui change
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Résume l'intrigue de Dune en deux phrases."}],
)
print(resp.choices[0].message.content)

同样的模式适用于 Node.js 和 curl；各模型价格及详细示例请参阅 Gemini API 价格指南。

安全保管密钥

• 使用环境变量，不要写入源代码。切勿将密钥提交到代码仓库；请从环境变量中读取。切勿将其暴露在浏览器或移动端构建包中——始终通过您自己的服务器调用。
• 每个项目或环境使用一个密钥。这样，泄露的密钥可以被撤销，而不会影响其他内容。
• 定期轮换。Kunavo 允许同时使用多个有效密钥，因此轮换可以平滑衔接，而不是突然中断。
• 按密钥设置支出上限。在控制面板中为每个密钥设置限制，并在 /app/usage 中监控每个密钥的异常流量。

常见问题