Gemini API Key 获取与购买全攻略：
免费申请、价格、额度与避坑
Gemini API Key 仍然可以通过 Google AI Studio 申请，但现在真正麻烦的不是“能不能创建 Key”，而是免费额度、付费账单、模型价格和国内调用方式都比早期更复杂。如果你只是做 demo，免费层级通常够用；但如果要接入网站、插件、自动化脚本或商业应用，就必须提前弄清楚账号能否开通付费、当前模型是否可用、延迟是否稳定，以及 token 成本会不会失控。
这篇文章会按真实使用路径，把 Gemini API Key 申请、价格层级、Flex / Priority、$300 赠金误区、常见报错和购买方案一次讲清楚。价格与模型信息以 Google 官方文档为准，社区反馈只作为风险提醒。
⚠️ 5 月紧急避坑：先迁移 Flash-Lite，再谨慎评估 Interactions API
这几天最值得开发者先检查的，不是“还能不能创建 Gemini API Key”，而是你代码里写的模型名是不是还停留在旧的 preview 口径。Google 官方模型页已经把 gemini-3.1-flash-lite 作为稳定版列出来，说明 Flash-Lite 这条线已经从“只建议尝鲜”进入了“可以作为正式接入目标”的阶段。
更关键的是，官方 deprecations 页面已经给出迁移方向：旧的 gemini-3.1-flash-lite-preview 不应该再作为新项目的默认选择。即使你今天还没有遇到 404，也最好把生产代码、环境变量、回退链路和文档说明，逐步切换到稳定版 gemini-3.1-flash-lite。这样做的意义不是“为了追新”，而是避免后面真正出现模型停用时再临时救火。
更稳的处理顺序：先检查代码中的模型名、SDK 版本和账号可用模型列表；如果你正在从旧的 preview 字符串迁移，优先改成 gemini-3.1-flash-lite，再观察是否还有 404、权限不足或响应结构变化问题。
另一个要单独提醒的是 Interactions API。官方页面在 2026 年 5 月 7 日更新时，仍然明确把它标成 Beta，并写明 schema、SDK 方法签名和特定功能行为都可能出现 breaking changes。这意味着，如果你要用它做 Agent、多步工具调用、服务端状态管理，当然可以开始评估；但如果你现在已经有一套基于 generateContent 的稳定生产链路，就不要为了追新一次性全量切过去。
一句话概括当前最稳的策略：模型层面尽快从旧的 preview 名称迁移到稳定版 Flash-Lite；接口层面继续把 generateContent 作为生产默认方案，把 Interactions API 当成新能力试点。这样既能跟上最新模型，又不会把整个线上调用链绑在 Beta 接口上。
一、Gemini API Key 怎么免费申请
官方申请入口是 Google AI Studio。正常情况下，登录 Google 账号后进入 API Keys 页面，就可以创建项目级 API Key。这个 Key 可以用于 Gemini API 的文本、图片、文件理解、结构化输出、函数调用等能力。
申请步骤
进入 Google AI Studio
打开 aistudio.google.com，登录你的 Google 账号。
找到 API Keys
进入控制台左侧的 API Keys 页面，选择创建新的 API Key。
选择或创建项目
如果系统要求绑定 Google Cloud 项目，可以新建一个专门用于 Gemini API 的项目，避免和主账号其它业务混在一起。
复制并保存 Key
API Key 只应该保存在后端服务、环境变量或密钥管理工具里，不要放进前端 JavaScript、App 包或公开 Git 仓库。
免费层级适合什么人
官方价格页仍然保留 Free 层级，适合开发者和小项目起步测试。免费层级通常包含有限模型访问、免费的输入/输出 token 和 AI Studio 使用权限，但免费层级的内容可能会被用于改进产品。如果你还不清楚 RPM、TPM、RPD 这些限制代表什么，可以先看 Gemini API 配额限制说明。
建议：免费 Key 适合做 demo、学习、低频脚本和功能验证，不适合直接处理隐私数据、客户资料、订单内容或生产业务。
二、Gemini API 价格怎么看：免费、Standard、Batch、Flex、Priority
Gemini API 现在不只是“免费版 vs 付费版”这么简单。官方价格页已经把不同模型拆成 Standard、Batch、Flex、Priority 等调用层级，区别主要在成本、延迟和稳定性。
| 层级 | 适合场景 | 主要特点 | 注意点 |
|---|---|---|---|
| Free | 学习、测试、低频 demo | 可免费开始，适合验证功能 | 模型和速率有限，内容可能用于改进产品 |
| Standard | 常规线上应用 | 按 token 计费，延迟和稳定性均衡 | 需要开通付费和账单 |
| Batch | 批量处理、离线任务 | 官方标注可降低批量成本 | 不适合实时聊天和即时响应 |
| Flex | 成本敏感、可接受排队的任务 | 官方在 Release Notes 中说明用于优化成本或延迟选择 | 不适合强实时场景 |
| Priority | 生产业务、高可靠调用 | 更偏稳定和低延迟 | 价格通常高于 Standard / Flex |
举个例子，官方价格页显示，gemini-3-flash-preview 的 Standard 文本/图片/视频输入价格为每 100 万 token 0.50 美元，输出为每 100 万 token 3.00 美元；Flex 输入为 0.25 美元、输出为 1.50 美元；Priority 输入为 0.90 美元、输出为 5.40 美元。
如果你用的是 gemini-3.1-pro-preview，价格会明显更高。官方价格页显示，Standard 在 20 万 token 以内的输入为每 100 万 token 2.00 美元，输出为 12.00 美元；Priority 在同样区间的输入为 3.60 美元，输出为 21.60 美元。
选型口诀：测试和普通内容处理优先 Flash；需要复杂推理、长文档和高质量输出时再考虑 Pro；批量任务优先看 Batch 或 Flex；付费业务和客户侧实时功能再考虑 Priority。
Gemini 3.1 Flash-Lite 与 File Search 怎么看
如果你的应用主要是批量分类、短文本摘要、标签生成、客服意图识别、日志归纳这类高频任务，优先关注 Flash-Lite 这条线。现在更准确的说法已经不是“先试试 gemini-3.1-flash-lite-preview”，而是优先把稳定版 gemini-3.1-flash-lite 当成默认低成本模型。它的定位不是取代 Pro 做复杂推理，而是在可接受质量下尽量降低成本和延迟。
按 Google 官方模型页，稳定版 Flash-Lite 支持文本、图片、视频、音频和 PDF 输入，也支持 File Search、Structured outputs、Function calling、Flex inference 和 Priority inference。这意味着它不只是“便宜版分类器”，也足够承担很多轻量级 Agent、数据抽取和文档处理工作。
另一个值得开发者关注的是 Gemini API File Search。官方文档说明，File Search 可以让模型基于上传文件进行检索回答，并返回引用信息；在 Gemini 3 系列中，还可以和结构化输出结合。对知识库问答、合同检索、客服资料库、内部 SOP 问答来说，这比自己从零搭建切片、向量库、引用回溯要省事很多。
实践建议：个人项目可以先用稳定版 gemini-3.1-flash-lite 或 gemini-3-flash-preview 跑通低成本链路；需要文件问答时再评估 File Search；只有当任务涉及复杂推理、长上下文决策或高质量写作时，再把 Pro 放到关键步骤。
三、$300 免费赠金还能不能直接用在 Gemini API 上
很多教程会把“Google Cloud 新账号 $300 免费赠金”和 Gemini API 免费使用混在一起讲，但现在不能再这么写死。
近期开发者社区里有用户反馈：新 Google 账号仍能进入 AI Studio 创建 API Key，但不一定能像过去那样顺畅使用 GCP $300 赠金完成 Gemini API 付费测试。这类反馈不能当作官方规则，但它提醒我们一个现实问题：不同地区、账号状态、账单配置和项目风控，都会影响你的实际可用额度。
更稳妥的说法是：Gemini API 免费层级和 Google Cloud 赠金不是同一个概念。你可以先用 AI Studio 的免费层级测试；如果要进入生产或高频调用，就应该以官方价格页、账单页和当前账号实际显示为准。
避坑提醒：不要在没有确认账单和用量上限的情况下，把 Gemini API Key 直接接入高频任务。建议先设置项目预算、用量提醒和 spend cap，避免脚本循环调用导致意外账单。
四、国内开发者怎么选择 Gemini API 方案
国内使用 Gemini API 的主要难点不是“有没有 Key”，而是网络、支付、账号风控和稳定性。不同用户适合的方案不一样。
1. 官方 Key：适合技术能力强、能处理账单的人
如果你能正常访问 Google AI Studio，也能绑定可用的付款方式，官方 Key 是最干净的方案。优点是链路短、权限清楚、账单透明，适合长期项目和生产环境。如果你的主要问题是 Gemini 网页版或 API 在国内访问不稳定，可以先参考 国内如何使用 Gemini 这篇基础排查。
缺点是国内网络环境下可能遇到连接超时、地区限制、账单开通失败或账号风控。如果你是新账号，不建议刚注册就高频创建项目、反复切换 IP、马上拉满 API 调用。
2. 自建反代：适合懂部署的人
自建 Cloudflare Worker、服务器代理或网关可以解决一部分访问问题，但它不是“免费稳定万能方案”。你需要自己维护域名、日志、限流、密钥安全和错误处理。
如果只是个人学习，自建反代可以尝试；如果是商业应用，建议至少加上鉴权、速率限制、日志脱敏和异常告警。
3. API 中转平台：适合想快速接入的人
如果你不想处理外币卡、账单、网络和代理，中转平台确实更省事。它的优势是国内直连、支付方便、接入快，适合做原型、内部工具、小团队应用和短期测试。
但中转平台的风险也要讲清楚：请求会经过第三方服务商，稳定性、隐私、模型真实性和售后都要看平台能力。涉及客户隐私、财务数据、医疗法律内容时，不建议随便走不可信的中转。
如果你只是要快速验证 Gemini API 能力，可以先用小额度套餐测试延迟和可用性；如果要长期使用，再评估是否转官方付费或独享 Key。对于想在编辑器里接入 Gemini 的开发者，也可以继续看 Gemini VSCode 插件安装教程。
五、Gemini API 常见报错与解决办法
404 model not found
通常不是 API Key 本身坏了，而是模型名不可用、模型已下线、当前账号没有权限，或 SDK 版本太旧。最近尤其要先检查你是不是还在调用旧的 preview 模型名，再去 AI Studio 或官方模型列表确认当前可用模型。
429 Too Many Requests
一般表示请求太频繁、token 太多，或当前项目的 RPM / TPM 限制不够。解决办法是降低并发、缩短上下文、开启重试退避，或者升级付费层级。
账单开通失败
通常和付款方式、账号地区、风控、项目权限有关。不要频繁换卡、换 IP、换设备反复提交，先确认 Google Cloud Billing 是否正常，再回到 AI Studio 升级付费。
六、Gemini API Key 安全与成本控制
API Key 最怕两件事：泄露和账单失控。只要你的 Key 被放进前端页面、公开仓库或客户端 App，就有被抓取和滥用的风险。
不要硬编码：把 Key 放在服务端环境变量里，不要写进 HTML、JS、移动端安装包或 GitHub。
给项目设预算：在 Google Cloud 或 AI Studio 账单里设置预算、提醒和支出上限。
区分测试和生产：测试环境用低成本 Flash 模型，生产环境根据质量需求选择 Pro 或 Priority。
记录每次调用：至少记录模型、token、耗时、状态码和错误信息，方便发现异常消耗。
敏感数据慎用免费层级：官方价格页说明免费层级内容可能用于改进产品，涉及隐私或商业数据时应使用付费层级或企业方案。
七、Gemini API Key 购买和独享方案怎么选
如果你只是学习，优先官方免费 Key；如果你是开发者，优先官方付费 Key；如果你在国内调用不稳定、没有可用付款方式，或者只是想先快速跑通业务，可以考虑正规中转或独享 Key 服务。
选择第三方方案时，不要只看价格。更应该看是否支持稳定模型、是否能提供清晰 Base URL、是否有用量记录、是否能限制额度、是否有售后，以及是否明确说明数据处理方式。
如果你正在做网站插件、自动化脚本、批量内容处理或内部工具，可以先用小额度测试响应速度和稳定性。确认模型、延迟和成本都能接受后，再切换到长期方案。
八、常见问题解答
Gemini API Key 是免费的吗？
可以免费开始使用，但免费层级有模型、速率和数据使用限制。正式项目仍建议开通付费层级，并设置预算和用量提醒。
为什么我的新账号没有 $300 赠金？
$300 GCP 赠金和 Gemini API 免费层级不是同一件事。不同账号、地区、账单状态和风控条件会影响赠金或付费能力，具体以你的 Google Cloud Billing 和 AI Studio 页面显示为准。
Flex 和 Priority 模式选哪个更划算？
能接受更高延迟、主要跑批量任务时，优先看 Flex；面向用户实时请求、需要更稳定响应时，再考虑 Priority。普通开发测试不必一开始就用 Priority。
Gemini 3.1 Flash-Lite 适合什么 API 场景？
它更适合高频、成本敏感、对响应速度要求高但不需要最强复杂推理的任务，例如批量分类、摘要、标签生成、轻量客服和大规模数据提取。现在优先使用稳定版 gemini-3.1-flash-lite，只有在你明确需要对照旧环境时才保留 preview 口径。
Gemini API 的 File Search 可以替代自己做向量数据库吗？
小型知识库和文件问答可以优先试 File Search，因为它能处理文件检索和引用来源；但如果你需要完全控制索引策略、权限隔离和企业级数据治理，仍可能需要自建检索系统。
为什么最近调用 gemini-3.1-flash-lite-preview 容易报 404 或模型不可用？
不一定是 API Key 被封。更常见的原因是模型名仍写着旧的 preview 版本、账号还没拿到目标模型权限，或者 SDK 太旧导致请求格式和当前模型能力不兼容。现在更稳的做法是优先迁移到稳定版 gemini-3.1-flash-lite，并检查官方模型页、SDK 版本和当前账号可用模型列表。
Interactions API 值得现在就全面迁移吗？
如果你要做新的 Agent 工作流、服务端状态管理或多步工具编排，可以开始评估 Interactions API；但官方页面仍明确标注它处于 Beta，schema 和 SDK 接口都可能出现 breaking changes。生产环境里，已有稳定链路的项目不必为了追新而一次性全量切换。
国内使用 Gemini API 一定要中转吗？
不一定。如果你的网络、账单和账号都正常，官方 Key 是首选。中转更适合无法稳定直连、没有可用付款方式或想快速验证项目的人。
九、核心要点总结
Gemini API Key 仍然可以通过 Google AI Studio 获取，但现在更应该关注模型是否可用、旧的 preview 名称是否需要迁移、账单是否正常、免费层级是否适合你的数据场景，以及调用成本是否可控。
对个人测试来说，免费层级和稳定版 gemini-3.1-flash-lite 已经够用；对生产项目来说，官方付费、预算控制、日志监控和合适的推理层级更重要；对需要 Agent 新能力的团队来说，Interactions API 可以试点，但别把整个稳定生产链路一次性压到 Beta 接口上。