获取 Gemini API 密钥的方法 — Google AI Studio 与 Kunavo

Gemini API 密钥是用于验证 Google Gemini 模型调用的 bearer 凭证。获取密钥有两种方式——在 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. 用于原型开发的 免费级别存在请求限制，适合初期开发。
4. 要处理生产环境流量，必须将密钥关联到已启用计费的 Google Cloud 计费账号。

如果 Gemini 以后仍是你唯一调用的模型，这条路径很合适。但如果还要使用 Claude 或图像/视频模型，你就需要分别管理各提供商的密钥、SDK 和账单。

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

Kunavo 将 Gemini 放在 OpenAI 兼容端点之后。使用一个 sk-kn- 密钥调用所有模型，并通过一个 Stripe 余额支付，因此无需 Google Cloud 项目。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。

快速开始

直接使用官方 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",  # 바뀌는 건 이 줄뿐입니다
)

# 모델 슬러그만 바꾸면 Claude, GPT 등 다른 모델도 같은 키로 호출됩니다
resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "두 문장으로 자기소개를 해줘."}],
)
print(resp.choices[0].message.content)

安全管理密钥

• 使用环境变量。不要将密钥硬编码到代码中，而应将其存放在类似 KUNAVO_API_KEY 的环境变量中。浏览器或移动端构建包会公开密钥，因此绝不要将密钥暴露在客户端，始终通过自己的服务器进行代理。
• 定期轮换。Kunavo 允许同时存在多个活跃密钥，因此你可以平稳重叠轮换，而不是进行突然切换。建议每季度轮换一次。
• 为每个密钥设置支出上限。在控制台中为每个密钥指定支出上限，并在 /app/usage 查看按密钥统计的用量。这样即使密钥泄露，也可以只废弃该密钥，而不会影响其他密钥。

常见问题