返回指南
API 密钥·2026年6月18日·更新于 2026年9月24日·阅读约 8 分钟

创建 Google Gemini API 密钥——两种方式(Google AI Studio 与 Kunavo)

如何创建 Google Gemini API 密钥——通过 Google AI Studio 的官方方式,以及通过 Kunavo 单密钥的方式;后者无需 Google Cloud 项目,同时可访问 Claude、GPT、图像和视频模型。

Gemini API Key用于验证你对 Google Gemini 模型的调用:每个请求都会在Authorization标头中携带密钥,平台据此统计并计费。有两种方式可以创建 Gemini API Key——直接通过 Google AI Studio(官方方式),或通过 Kunavo:使用一个 OpenAI 兼容密钥访问 Gemini、Claude、GPT 以及图像/视频模型,完全无需 Google Cloud 项目。

选项 1——创建 Google AI Studio API Key(官方方式)

如果你今后只调用 Gemini,可以直接从 Google 获取密钥:

  1. 访问aistudio.google.com并使用 Google 账户登录。
  2. 打开Get API key → Create API key。密钥以AIza…开头,并且只显示一次。
  3. 免费层有速率限制,适合原型开发。用于生产时,请将密钥关联到Google Cloud 结算账户。

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

选项 2——通过 Kunavo 创建 Gemini API Key(推荐用于生产)

Kunavo 将 Gemini 放在 OpenAI 兼容 API 后面。一个sk-kn-密钥即可通过同一个端点访问所有模型——无需 Google Cloud 项目,Gemini 价格约比 Google 列表低70%($0.09 / $0.75每 1M 令牌),使用一个 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和模型名称,其他无需改变。

gemini_quickstart.py
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # die einzige Zeile, die sich ändert
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Fasse die Handlung von Dune in zwei Sätzen zusammen."}],
)
print(resp.choices[0].message.content)

Node.js 和 curl 也采用相同模式;每个模型的费率和完整计算示例见Gemini API 定价指南。

安全保存密钥

  • 使用环境变量,而不是源代码。绝不要将密钥放入仓库;应从环境变量中读取。绝不要将其暴露给浏览器或移动端构建包——始终通过自己的服务器进行代理。
  • 每个项目或环境使用一个密钥。这样可以在密钥泄露时撤销该密钥,而不会影响其他所有内容。
  • 定期轮换。Kunavo 允许同时使用多个有效密钥,因此轮换可以平滑重叠,而不是突然中断。
  • 设置每个密钥的输出限制。在控制面板中设置每个密钥的限制,并在/app/usage下关注每个密钥的异常流量。

常见问题

如何创建 Google Gemini API Key?

有两种方式。官方方式:打开 aistudio.google.com,使用 Google 账户登录,点击“Get API key”→“Create API key”;密钥以 AIza… 开头,并且只显示一次。通过 Kunavo:在 kunavo.com 注册,至少充值 $10,在 /app/keys 下生成密钥,并将 OpenAI SDK 指向 https://api.kunavo.com/v1。第二种方式不需要 Google Cloud 项目,同一个密钥还可以访问 Claude、GPT 以及图像和视频模型。两种方式都能在不到五分钟的时间内完成。

如何在 Google AI Studio 中创建 API Key?

在 Google AI Studio 中:访问 aistudio.google.com,使用 Google 账户登录,点击左上角的“Get API key”,然后点击“Create API key”,并选择现有或新的 Google Cloud 项目。密钥只会显示一次——立即复制并存入环境变量。免费层有速率限制;如需生产规模,请将项目关联到 Google Cloud 结算账户。

什么是 Gemini Key?在哪里可以再次找到它?

Gemini Key 是用于验证发送到 Google Gemini 模型的每个请求并将其归属于计费的字符串;它会随 Authorization 标头发送。Google 只在创建时显示完整密钥——之后在 Google AI Studio 中只能看到名称和创建日期。如果密钥丢失,请删除并创建新密钥;无法恢复。Kunavo 的原理相同:密钥只显示一次,之后在 /app/keys 下只能看到元数据和用量。

为什么我的 Gemini API Key 无法使用?

API_KEY_INVALID最常见的原因是密钥复制不完整,或环境变量中包含空格或换行。其次可能是:密钥属于其他 Google Cloud 项目、项目未启用 Gemini API,或密钥已被撤销。首先检查该值是否准确以AIza开头。对于 Kunavo 密钥,最常见的原因是余额已用尽——此时返回的是402,而不是401。完整错误列表见无效 Gemini API Key 指南。

Gemini API 免费吗?

Google AI Studio 提供一个速率限制较低的免费层密钥,足以用于原型开发。生产流量需要付费计费。Kunavo 采用按量付费,最低充值金额为 $10,无需单独的 Google Cloud 结算账户,而且余额永不过期。

Gemini API Key 可以在没有 Google Cloud 账户的情况下使用吗?

可以。Google AI Studio 密钥可在没有 Google Cloud 项目的情况下用于原型开发,但有速率限制;生产规模的使用需要 Google Cloud 结算账户。Kunavo 密钥完全不需要 Google Cloud 项目——你可以通过 OpenAI 兼容端点调用 Gemini,并通过 Stripe 统一结算。

Gemini Key 与 Kunavo Key 有什么区别?

Google 密钥只能调用 Gemini,并通过 Google Cloud 账户结算。Kunavo 密钥通过 OpenAI 兼容 API 调用 Gemini、Claude、GPT、图像和视频模型,使用一个 Stripe 余额,且无需 Google Cloud 项目。每个模型的价格见Gemini API 定价指南。

应该从哪个 Gemini 模型开始?

日常聊天、提取和摘要可以从gemini-2-5-flash开始——速度快且价格很低。对于更困难的推理、视觉和长上下文分析,请切换到gemini-3-1-pro。