
Google AI Studio 怎么用?Gemini 模型选择、免费 API 与接入教程(2026)
Google AI Studio 是 Google 官方的 Gemini 原型设计、提示词调试和 API 开发工具。你可以先在网页里测试模型,再创建 API Key 接入自己的应用。
本文核对于 2026 年 11 月 12 日。旧版重点介绍 Gemini 2.5 / 3.0,当前官方模型页已经列出 Gemini 4 Carbon、Gemini 4 Argon、Gemini 3.8 Flash 等新模型,不能继续照搬旧模型名和旧配额。
Google AI、Gemini、AI Studio 和 Vertex AI 的区别
- Gemini:Google 的模型与应用品牌。
- Gemini App:面向普通用户的聊天和任务入口。
- Google AI Studio:面向原型验证和开发者的调试工作台,可创建 Gemini API Key。
- Vertex AI:面向企业部署、权限、治理和云上生产环境的平台。
只想聊天时先用 Gemini App;需要测试提示词、比较模型、获取 API Key 时,用 AI Studio;需要企业权限和生产治理时,再评估 Vertex AI。
当前模型怎么选
根据 AI Studio 当前模型页,常见选择如下:
| 模型 | 模型代码 | 更适合的任务 |
|---|---|---|
| Gemini 4 Carbon | gemini-4-carbon |
复杂软件工程、多模态知识工作、科学推理 |
| Gemini 4 Argon | gemini-4-argon |
希望兼顾前沿推理、速度和 Token 成本 |
| Gemini 3.8 Flash | 以模型页当前代码为准 | 长任务、Agent、日常开发与高吞吐场景 |
| Gemini 3.8 Live | 以 Live API 文档为准 | 低延迟语音交互 |
| Gemini 3.6 Flash | 以模型页当前代码为准 | 稳定、通用的日常任务 |
Gemini 4 Carbon 和 Argon 当前均标注 1M Token 上下文。不要再把「Gemini 2.5 Pro 的 200 万上下文」当成整个产品线的固定卖点。
模型名称、预览状态和可用区域会变化,写代码前应复制模型页里的当前模型代码,不要只照抄文章截图。
免费层和限流怎么理解
免费 API 不等于无限调用。Gemini API 的限制通常同时看:
- RPM:每分钟请求数;
- TPM:每分钟输入 Token 数;
- RPD:每天请求数;
- 部分模型还可能有图片、音频或输出相关限制。
任意一个维度超限都可能返回 429 RESOURCE_EXHAUSTED。限制按项目而不是按单个 API Key 计算,每天请求配额的 reset 使用太平洋时间。
不同模型和用量层级的数字不同,预览模型通常更严格。最可靠的查询方式是在 AI Studio 打开 View your active rate limits,查看自己项目的实时值,而不是沿用旧文的「每天 1500 次」。
4 步创建并使用 API Key
第 1 步:打开官方工作台
访问 aistudio.google.com,登录 Google 账号。
第 2 步:先跑一个最小提示词
选择一个当前可用模型,输入短提示词,确认回答、输出语言和预期格式。先验证模型是否符合任务,再创建 Key。
第 3 步:创建 API Key
在工作台进入 API Key 管理页面,按提示选择或创建 Google Cloud 项目并生成 Key。
Key 属于敏感凭证:不要贴进文章、前端页面、公开仓库或聊天记录,也不要为了共享额度而多人共用。
第 4 步:用官方示例完成第一次调用
从官方文档复制当前模型对应的请求示例,把模型代码和 Key 换成自己的。先用短输入验证,再逐步增加文件、图片或长上下文。
接入第三方工具要注意什么
接入 NextChat、翻译插件或其他客户端时,重点检查四项:
- Base URL 和协议:确认工具支持 Gemini 原生 API,还是需要 OpenAI 兼容层。
- 模型代码:不要沿用下拉列表里不存在的旧模型。
- 额度:同一项目下多个工具共享限流,不是每个客户端各有一份。
- 数据规则:免费与付费服务的数据使用规则可能不同,敏感资料先核对当前条款。
常见报错怎么处理
| 情况 | 优先检查 | 处理方式 |
|---|---|---|
| 401 / Key 无效 | Key、项目、请求头 | 重新复制 Key,确认没有空格或泄露后吊销重建 |
| 404 / 模型不存在 | 模型代码、区域、账号权限 | 回模型页复制当前代码,不用旧教程截图 |
| 429 | RPM、TPM、RPD、项目共享用量 | 降低并发、缩短输入、指数退避,查看实时限制 |
| 返回内容与旧教程不同 | 模型版本和系统提示词 | 固定模型与参数,保存可复现测试样例 |
| 长文档失败 | 当前模型上下文和文件限制 | 拆分文档,先测小文件,不只看标称上下文 |
总结
Google AI Studio 仍然是调试 Gemini 和获取 API Key 的官方入口,但模型与配额更新很快。当前应优先看 Gemini 4 Carbon、Gemini 4 Argon 和 Gemini 3.8 Flash 等现役型号,并以自己项目的 Rate limits 页面为准。
官方来源
最后更新:2026 年 11 月 12 日。
常见问题
Google AI Studio 还能免费用吗?
可以根据当前免费层规则使用部分模型和能力,但配额受项目、模型、区域和用量层级影响,以账号内实时限制为准。
创建多个 API Key 能增加免费额度吗?
不能简单这样理解。限流按项目计算,同一项目下多个 Key 不是多份独立额度。
Gemini 4 的上下文是多少?
当前模型页给 Gemini 4 Carbon 和 Argon 标注 1M Token。具体输出上限、模态和可用接口以对应模型页为准。
免费层数据会被用于训练吗?
不同服务和计费层级的数据规则不同。处理商业机密、个人隐私或未公开代码前,必须阅读当前数据使用条款,不要凭旧截图判断。

京ICP备2024094994号-29