Gemini 使用指南

主题

Gemini API Key申请与调用教程（2026）：Python、Node.js和curl入门 ​

最后更新：2026-08-08。Google AI Studio 的模型列表、地区支持、免费层、速率限制和计费规则会变化，本文不写固定配额或价格；请以 Google AI for Developers 和控制台实时显示为准。

如果你搜索“Gemini API Key怎么申请”，完整流程可以概括为：进入 Google AI Studio，使用符合条件的 Google 账号登录，在 API Key 页面创建密钥，然后用官方 SDK 或 REST 接口发出第一条请求。真正容易出问题的地方不是复制代码，而是密钥权限、模型名称、地区可用性、配额和安全保存。

Gemini API Key申请前先确认三件事 ​

检查项你需要确认什么为什么重要
账号和地区AI Studio 是否能打开，账号是否能登录地区或账号资格可能影响 API 使用
模型和接口控制台当前显示哪些模型和 API 能力旧文章中的模型名可能已下线或改名
费用和配额当前项目的免费层、速率限制和计费方式不同模型、项目和账户的限制可能不同

开发者可以先阅读官方 Gemini API 文档 和 API Key 说明。如果你只是想体验中文对话，并不需要把 Gemini 接入自己的程序，可以先查看 GPTCat 或 SnakeGPT；它们是第三方 AI 平台，不是 Google 官方 API。

如果你的重点是让网站、脚本或自动化流程尽快接入多种模型 API，也可以了解本站的 ZeoAPI。ZeoAPI 是第三方 API 聚合平台，不是 Google 官方 API，也不代表 Google 授权；注册或接入前仍应以平台当前的接口文档、运营主体、数据保留、计费和退款规则为准。

第一步：在 Google AI Studio 创建 API Key ​

  1. 打开 Google AI Studio，确认地址栏域名正确。
  2. 使用符合服务要求的 Google 账号登录。
  3. 在控制台中进入 API Key 管理或创建密钥的页面。
  4. 选择已有项目，或按页面提示创建一个新项目。
  5. 创建后立即复制密钥，并保存到本地密钥管理工具或环境变量中。
  6. 回到控制台确认项目、模型、配额和计费设置，不要把密钥直接写进公开代码。

界面按钮名称可能随 AI Studio 更新而变化。如果找不到 API Key 菜单，应先确认自己进入的是 AI Studio，而不是普通 Gemini 对话页面。

第二步：用环境变量保存密钥 ​

不要把真实密钥写进 Markdown、前端 JavaScript、Git 仓库或截图。开发环境可以使用环境变量：

macOS / Linux ​

bash
export GEMINI_API_KEY="你的_API_KEY"

Windows PowerShell ​

powershell
$env:GEMINI_API_KEY = "你的_API_KEY"

程序中读取环境变量，而不是把密钥硬编码：

python
import os

api_key = os.environ["GEMINI_API_KEY"]

如果密钥已经提交到公开仓库，应立即在 Google AI Studio 中撤销或轮换，并检查访问日志和费用变化。不要只删除代码中的那一行，因为 Git 历史可能仍然保留旧密钥。

第三步：用 curl 发出第一条请求 ​

REST 请求适合验证网络、密钥和模型名是否基本可用。下面的 MODEL_NAME 只是占位符，请替换为 AI Studio 当前显示且你的项目可用的模型：

bash
curl "https://generativelanguage.googleapis.com/v1beta/models/MODEL_NAME:generateContent?key=${GEMINI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [
          {"text": "请用简体中文介绍 Gemini API。"}
        ]
      }
    ]
  }'

Windows PowerShell 可以先把请求体保存为对象，再使用 Invoke-RestMethod：

powershell
$body = @{
  contents = @(
    @{ parts = @(@{ text = "请用简体中文介绍 Gemini API。" }) }
  )
} | ConvertTo-Json -Depth 5

$uri = "https://generativelanguage.googleapis.com/v1beta/models/MODEL_NAME`:generateContent?key=$env:GEMINI_API_KEY"
Invoke-RestMethod -Method Post -Uri $uri -ContentType "application/json" -Body $body

如果第一条请求失败，先检查 URL 中的模型名、API Key、请求方法和 JSON 格式，再判断是不是地区或配额问题。

Python调用示例 ​

Google 的 Python SDK、导入路径和模型支持会随版本更新。安装前查看官方 quickstart，使用当前推荐的包和写法。下面示例展示调用结构，模型名仍需替换为控制台实时可用值：

bash
pip install -U google-genai
python
import os
from google import genai

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="MODEL_NAME",
    contents="请用三句话说明 Gemini API 适合什么任务。",
)

print(response.text)

Python调用图片或文件时 ​

多模态请求的具体输入格式取决于 SDK 当前版本和附件类型。不要先照抄旧教程中的 google-generativeai 示例；先查看官方 SDK 文档，再确认文件大小、MIME 类型和数据保留规则。

Node.js调用示例 ​

安装当前官方 JavaScript SDK 后，可以使用环境变量初始化客户端：

bash
npm install @google/genai
javascript
import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  apiKey: process.env.GEMINI_API_KEY,
});

const response = await ai.models.generateContent({
  model: "MODEL_NAME",
  contents: "请用简体中文回答：Gemini API 的第一步是什么？",
});

console.log(response.text);

如果项目仍然使用旧 SDK，请先阅读官方迁移说明，再决定是否升级。不要为了追求某个旧模型名而锁死过期依赖。

Gemini API模型怎么选 ​

不要把模型名称直接写成永久结论。更稳妥的选择方式是：

  • 速度和成本优先：在控制台选择当前 Flash 或同类快速模型；
  • 复杂推理和代码：选择当前可用的 Pro 或推理类模型；
  • 图片、音频、视频或文件：确认模型和接口支持对应输入；
  • 生产环境：先用固定提示词做回归测试，再观察延迟、错误率和实际费用。

模型的上下文长度、输入输出限制、速率、计费和地区支持都可能变化。建议在应用启动时记录模型名和 SDK 版本，方便后续排查。

常见报错和排查顺序 ​

401、403 或 API Key 无效 ​

检查密钥是否复制完整、是否被撤销、是否属于正确项目，以及请求 URL 是否使用了正确的接口版本。不要把密钥粘贴到公开的错误日志中。

404 或模型不存在 ​

通常是模型名、接口版本或调用方法不匹配。回到 AI Studio 当前模型列表和官方文档，确认该模型是否支持你使用的接口。

429 或配额超限 ​

可能是速率、并发、每日额度或项目账单限制。降低请求频率、增加重试退避，并查看控制台实际配额；不要用大量轮询掩盖问题。

User location is not supported ​

这通常与请求来源地区或服务政策有关。确认当前地区支持范围和官方说明，不要把未经授权的“绕过限制”脚本当成稳定方案。

返回内容为空或结构变化 ​

检查 SDK 版本、响应字段和安全设置。生产代码应对空响应、超时、重试和结构变化做防御式处理，不能只依赖一次成功响应。

生产环境上线前检查清单 ​

  • API Key 只放在服务端或密钥管理系统；
  • 为不同环境使用不同项目或密钥，便于撤销和审计；
  • 设置请求超时、指数退避和最大重试次数；
  • 记录模型名、SDK 版本、请求耗时和错误类型，但不要记录敏感 prompt 或密钥；
  • 为输入长度、文件大小和并发数设置上限；
  • 在控制台设置预算、配额或费用提醒；
  • 对模型输出做格式校验、敏感信息过滤和人工复核；
  • 上线前用真实业务样本做回归测试。

国内开发者的替代路线 ​

如果官方 API 因账号、地区或网络环境暂时无法使用，可以研究第三方 API 平台，但需要单独核对运营主体、接口文档、数据保留、计费和退款规则。本站自有的 ZeoAPI 属于 API 聚合平台，支持多类模型 API；它不是 Google 官方 API，也不代表 Google 授权。

普通用户如果不需要写代码，只是想直接进行中文对话，可以查看 GPTCat 或 SnakeGPT。这两个产品同样是第三方 AI 平台，模型和额度以各自页面实时信息为准。

常见问题 ​

Gemini API Key在哪里申请？ ​

通常在 Google AI Studio 登录后，从 API Key 管理页面创建。界面和按钮名称可能更新，找不到入口时请查看官方 API Key 文档。

Gemini API有免费额度吗？ ​

部分模型或项目可能提供免费层，但额度、速率和地区条件会变化。不要引用旧文章中的固定 RPM、TPM 或每日次数，直接以控制台和官方定价页为准。

Gemini API Key可以放在前端吗？ ​

不建议。浏览器前端、移动端安装包和公开仓库都可能泄露密钥。应由服务端保存密钥，并通过自己的后端接口向前端提供受控能力。

Gemini API支持Python和Node.js吗？ ​

Google 提供面向多种语言的 SDK 或 REST 调用方式。安装前先查看当前官方 quickstart 和 SDK 版本，避免使用过时导入路径。

Gemini API调用报错怎么办？ ​

按“密钥 → 项目 → 模型名 → 请求格式 → 地区 → 配额”的顺序排查，并保留不含密钥的错误码和请求时间，方便定位。

普通用户需要申请Gemini API Key吗？ ​

如果只是聊天、翻译或写作，通常不需要自己申请 API Key；可以使用官方 Gemini 网页或第三方中文平台。需要把模型接入程序、网站或自动化流程时，才需要 API。

总结 ​

申请 Gemini API Key 的核心流程是：从 Google AI Studio 创建密钥，用环境变量安全保存，再用官方 SDK 或 REST 发出第一条请求。真正上线前，还要核对模型列表、地区、配额、费用、超时和隐私。开发者可继续参考 Gemini API 中文开发文档；普通用户则可以先了解 Gemini国内怎么用 或测试 GPTCat、SnakeGPT。

本站是独立第三方中文信息站，与 Google、OpenAI 及相关 AI 厂商无授权或从属关系。

Copyright © 2026 Gemini 中文指南