如何获取 Gemini API 密钥——Google AI Studio 与 Kunavo 两种方法

Gemini API 密钥是用于验证对 Google 的 Gemini 模型调用的持有者凭据。有两种获取方式——从Google AI Studio（官方）获取，或使用Kunavo的一个 OpenAI 兼容密钥统一调用 Gemini、Claude、GPT 以及图像/视频模型（无需 Google Cloud 项目）。本指南将说明两种流程，以及生产环境应该选择哪一种。

方法 1——Google AI Studio（官方）

如果只使用 Gemini，直接从 Google 获取密钥是标准做法。

1. 使用 Google 账户登录 aistudio.google.com。
2. 打开获取 API 密钥 → 创建 API 密钥。密钥格式类似 AIza...。
3. 原型开发可以使用带速率限制的免费层。在生产处理量下，需要将密钥关联到已启用结算的 Google Cloud 项目。

如果调用的模型只有 Gemini，这是正确路径。但如果还要使用 Claude 或图像、视频模型，就需要分别管理每个提供商的密钥、SDK 和账单。

方法 2——Kunavo（推荐用于生产）

Kunavo 在 OpenAI 兼容 API 后提供 Gemini。使用一个 sk-kn- 密钥即可访问 Gemini 及所有其他模型，无需 Google Cloud 项目，支付统一归入 Stripe 的一个余额。Gemini 比 Google 的官方定价便宜约 70%，并可从$10 起按量计费。

1. 注册——在 kunavo.com 创建账户。
2. 充值 $10——按量计费，余额不会过期。
3. 创建密钥——在 /app/keys 中创建密钥。密钥以 sk-kn- 开头，且只显示一次，因此请保存到环境变量中。
4. 调用——将 OpenAI SDK 的 base_url 指向 https://api.kunavo.com/v1，并指定 Gemini slug。

两种方式的选择也可以通过Gemini API 密钥文档中的比较表确认。费用明细请参阅Gemini API 价格指南。

快速开始

直接使用官方 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",  # 変更するのはこの 1 行だけ
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",  # Gemini モデルのスラッグを指定
    messages=[{"role": "user", "content": "Gemini を一文で説明して。"}],
)
print(resp.choices[0].message.content)

安全管理密钥

• 使用环境变量。不要将密钥直接写入代码，而应从类似 KUNAVO_API_KEY 的环境变量中读取。由于浏览器和移动端构建包会公开，不要在客户端暴露密钥，务必通过自己的服务器代理。
• 定期轮换。 Kunavo 可以同时拥有多个有效密钥，因此轮换可以平滑重叠，而不是硬切换。建议以季度为周期。
• 为每个密钥设置上限。在 dashboard 中按密钥设置上限，并按项目或环境拆分密钥；即使发生泄露，也可以只撤销该密钥而不停止全部服务。通过 /app/usage 监控按密钥划分的流量。

常见问题