获取 Gemini API 密钥 — 使用 Google AI Studio 和 Kunavo 的分步指南

Gemini API 密钥是一种 bearer 凭证，用于验证你对 Google Gemini 模型的调用。获取密钥有两种方式：直接从Google AI Studio（官方方式）获取，或通过Kunavo获取 — 使用一把兼容 OpenAI 的密钥调用 Gemini、Claude、GPT 以及图像/视频模型，而且无需设置 Google Cloud 项目。本指南将逐步介绍两种方式，帮助你在几分钟内调用 Gemini。

选项 1 — Google AI Studio（官方）

如果你只使用 Gemini，可以直接从 Google 获取密钥：

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

如果你只会调用 Gemini，这是正确的方式。如果你还使用 Claude、图像或视频模型，就必须分别管理每个供应商的一把密钥、一个 SDK 和一张账单。

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

Kunavo 将 Gemini 放在兼容 OpenAI 的 API 后面。一个 sk-kn- 密钥即可通过兼容 OpenAI 的端点访问 Gemini 和其他所有模型 — 无需 Google Cloud 项目。Gemini 的价格约比 Google 列表价低 70%，所有服务共用一个 Stripe 余额，并且只需$10即可按量付费。

1. 创建 Kunavo 账户并充值 $10 — 按量付费，余额永不过期。
2. 在 /app/keys 页面创建密钥。密钥仅显示一次；请将其保存到环境变量中。
3. 将 OpenAI SDK 指向 https://api.kunavo.com/v1，并调用 Gemini slug。
4. 发起调用 — 发送类似 gemini-2-5-flash 的模型字段，仅此而已。

快速开始

你可以继续使用官方 OpenAI SDK。只需更改 base_url 和模型名称 — 其他内容都不要改：

import os
from openai import OpenAI

# Resmi OpenAI SDK'sını koruyun; yalnızca base_url ve model değişir.
client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # değişen tek satır
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Merhaba Gemini, kendini bir cümleyle tanıt."}],
)
print(resp.choices[0].message.content)

保护你的密钥

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

常见问题