ChatGPT 使用指南

外观

Gemini API 怎么用？Google AI Studio、API Key、配额与 429 排查（2026） ​

如果你条件有限，强烈推荐国内 API 站

这是站主自主搭建纯 GPT API 站，无需梯子，实时更新 GPT 最新模型（仅支持电脑端），价格是官方的 三分之一，操作简单，连接稳定，价格便宜，保证没有任何掺水、收集信息等低劣行为，保证爽用 GPT。

调用 Gemini API 的基本流程是：进入 Google AI Studio，在自己的项目中创建 API Key，再按照 Gemini API 快速入门 使用官方 SDK 或 REST 请求。模型 ID、免费层级、速率限制和计费规则会变化，发送请求前应以 Google 模型列表、AI Studio 和项目控制台的实时页面为准。

核验日期：2026 年 8 月 16 日。 Google 可能调整 SDK、模型、配额、地区资格和文档路径；页面显示不一致时，以官方当前说明为准。

先分清三个入口 ​

入口主要用途需要核对什么
Gemini 网页版普通对话、写作及账号开放的文件功能Google 账号、地区、套餐和工具权限
Google AI Studio测试提示词、查看模型、创建 API Key项目、密钥、模型状态和安全设置
Gemini API 文档SDK、REST、参数与错误说明API 版本、模型 ID 和请求格式

如果只是聊天，不需要创建 API Key；需要在自己的程序、网站或自动化流程中调用时，才进入 AI Studio 和 API 文档。

一、创建并保护 API Key ​

登录 AI Studio 后，按页面上的 Get API key / API keys 入口创建或选择项目。不同账号看到的按钮、项目选择器和资格可能不同，不要依赖旧截图；可同时查看官方 API Key 说明。

创建后应记录密钥属于哪个项目，并把它放在服务器环境变量或密钥管理服务中：

bash
GEMINI_API_KEY="替换为你的密钥"
GEMINI_MODEL="从官方模型列表复制的当前模型 ID"

不要把密钥提交到 Git、写进公开网页、截图或浏览器端 JavaScript。如果密钥已经公开，应立即在 AI Studio 撤销或轮换，并检查项目用量；仅从代码中删除不能清除历史提交和构建产物。

二、先核验模型，再写代码 ​

第三方教程中的旧型号、简称或营销名称不能直接作为 API 参数。建议按以下顺序确认：

  1. 打开 Google 的 Models 页面，查看模型 ID、输入输出能力和生命周期。
  2. 在 AI Studio 模型选择器中确认当前项目能看到该模型。
  3. 把完整模型 ID 放入 GEMINI_MODEL，避免在多个文件中写死版本号。
  4. 遇到 404 或 model not found 时，重新检查模型 ID、API 版本、项目权限和模型状态。

下面的代码故意使用环境变量，避免复制一个很快过期的具体型号。

三、官方 SDK 最小示例 ​

安装前先看 官方快速入门，因为 SDK 包名、导入路径和参数可能升级。

Python ​

bash
python -m 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=os.environ["GEMINI_MODEL"],
    contents="请用三句话解释什么是 API。",
)
print(response.text)

JavaScript / TypeScript ​

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: process.env.GEMINI_MODEL,
  contents: "请用三句话解释什么是 API。",
});
console.log(response.text);

四、REST 最小请求 ​

不安装 SDK 时，可以先用 REST 验证“密钥—项目—模型—网络”链路。GEMINI_MODEL 必须来自官方模型列表：

bash
curl "https://generativelanguage.googleapis.com/v1beta/models/${GEMINI_MODEL}:generateContent?key=${GEMINI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "用一句话说明怎样保护 API Key。"}]}]
  }'

先让短文本请求成功，再加入文件、流式输出、工具调用或并发。生产环境还应记录不含密钥的错误正文、请求 ID 和耗时，并设置客户端超时。

五、怎样核对配额与计费 ​

不要把文章中的固定数字当成当前额度。限制可能按项目、模型、账号层级、输入输出量和计费状态计算。应查看 Rate limits 官方说明、AI Studio 用量页和项目账单。

问题查看位置处理原则
模型是否可用Models 页面、AI Studio使用完整模型 ID
请求被限速Rate limits、错误正文和响应头降低并发，采用退避
费用与预算项目账单和用量页设置预算提醒，分离测试与生产项目
账号或地区资格AI Studio 与官方支持说明不伪造地区、不共享密钥

六、429、403 与常见错误 ​

429：限速或配额不足 ​

先查看响应正文、响应头和项目用量。降低并发与请求频率，减少重复请求，并采用带随机抖动的指数退避；如果响应提供 Retry-After，按它等待。持续出现时检查计费状态、项目配额和当前模型资格，不要无限循环重试。

403：密钥或项目权限 ​

检查密钥是否被撤销、项目是否正确、API 是否启用、密钥限制是否挡住当前来源，以及组织或账单策略是否要求额外权限。不要为绕过 403 而公开密钥或关闭所有安全限制。

400 / 404：请求或模型问题 ​

对照 API Reference 检查 JSON 结构、contents、parts 和 API 版本，再核对模型 ID。把复杂请求缩成一段短文本，能更快判断是格式、模型还是权限问题。

超时或空内容 ​

先测试短请求，检查网络、服务状态和客户端超时，再确认代码是否正确读取 SDK 返回对象中的文本字段。空响应不等于模型没有能力。

常见问题 FAQ ​

1. Gemini 网页版账号能直接调用 API 吗？ ​

网页端、AI Studio 项目和 API Key 是不同的产品与权限体系。开发调用应在 AI Studio 中创建或选择项目。

2. API Key 可以写进前端吗？ ​

不建议。前端代码和网络请求可以被查看，应把调用放在自己的服务端。

3. 为什么教程里的模型 ID 不可用？ ​

模型可能已更新、下线或未向你的项目开放。请查 Models 页面 和 AI Studio。

4. 429 代表密钥失效吗？ ​

通常更接近限速或配额问题，但必须结合错误正文、响应头和项目用量判断。

5. 403 与 429 有什么区别？ ​

403 更常见于密钥、项目或权限；429 更常见于速率和配额。两者都不应盲目重试。

6. 免费层级有固定额度吗？ ​

不宜写成固定承诺。额度会随模型、项目和时间调整，请查看 Rate limits 与 AI Studio 当前页面。

7. API 会读取网页版聊天记录吗？ ​

不会自动读取。API 只接收代码明确发送的内容，网页端历史记录和 API 项目应分别管理。

相关教程 ​

官方核验入口：Gemini API 文档 · API Reference · Google AI Studio。