AIFreeAPI Logo

Gemini API密钥等级申请完整指南:免费、Tier 1、Tier 2与Tier 3全攻略(2026)

A
18 分钟阅读API教程

获取Gemini API密钥,免费和Tier 1不到5分钟。Tier 2需要$250的真实API消费,Tier 3需要$1,000。本指南涵盖全部四个等级的详细步骤、密钥安全配置,以及一个重要陷阱:Google Cloud免费试用额度不计入等级升级门槛。

Gemini API密钥等级对比图,展示免费、Tier 1、Tier 2和Tier 3的访问级别与速率限制

获取Gemini API密钥对于免费访问来说非常简单,但从免费版升级到Tier 1、Tier 2和Tier 3的过程涉及特定的计费要求,让许多开发者困惑不已。免费版每分钟限15次请求,无需信用卡。一旦在Google Cloud项目上启用计费,就立即获得Tier 1资格。Tier 2需要累计真实API消费$250——重要提示:Google Cloud免费试用额度不计入门槛。Tier 3需要消费$1,000,某些最高吞吐量模型还需要联系Google销售团队。本指南详细讲解每个等级的具体步骤,包含经过验证的速率限制、精确的升级路径,以及大多数指南都跳过的安全配置章节。

要点速览

  • 免费版:无需信用卡,Gemini 2.0 Flash每分钟15次请求/每天1,500次(2026年3月验证)
  • Tier 1:在Google Cloud项目上启用计费——速率限制立即提升至150–2,000 RPM
  • Tier 2:需要$250实际API消费(不含额度)+ 启用计费满30天
  • Tier 3:需要$1,000实际API消费——某些模型需要联系Google销售
  • 安全性:始终为密钥设置IP、HTTP引用来源或API服务限制

理解Gemini API的四级权限系统

Gemini API等级升级路径,展示从免费到Tier 1、Tier 2、Tier 3的升级要求与速率限制
Gemini API等级升级路径,展示从免费到Tier 1、Tier 2、Tier 3的升级要求与速率限制

Gemini API采用四级权限系统,决定你的速率限制、可用模型和高级功能访问权限。每个等级与你的Google Cloud项目的计费历史绑定,而非个人账户。理解这一区别至关重要,因为许多开发者错误地认为Google Cloud的$300免费试用额度可以计入等级升级门槛——实际上不行。等级进阶是基于实际付款方式处理的真实消费金额单独追踪的。

等级系统数字概览:免费版Gemini 2.0 Flash每分钟15次请求,每天1,500次(经Google AI Studio文档验证,2026年3月)。一旦启用计费,立即跃升至Tier 1,Gemini 2.0 Flash每分钟150次请求,某些Flash变体高达2,000 RPM。Tier 2在累计真实消费$250且计费账户激活满30天后激活。Tier 3在消费$1,000后激活,解锁所有可用最高配额。更多免费版限制详情,请参阅Gemini API免费版速率限制详细指南

四个等级在可用模型方面也有所不同。免费版限制只能使用部分Gemini模型,排除了一些实验性或预览版模型。Tier 1开放完整生产模型目录的访问权限。Tier 2和Tier 3为计算密集型模型提供更高配额,如Gemini 2.0 Flash Thinking和Gemini 1.5 Pro,这些模型每个token的成本更高。如果你正在构建延迟和吞吐量都很重要的生产应用,在开始开发前了解自己需要哪个等级将节省大量时间。

等级要求Gemini 2.0 Flash RPMGemini 2.0 Flash RPD主要优势
免费151,500无需信用卡
Tier 1启用计费150–2,000无限制*完整模型目录
Tier 2真实消费$250 + 满30天1,000–4,000无限制*高吞吐量
Tier 3真实消费$1,0002,000–4,000+无限制*企业级配额

*无限制RPD表示没有每日请求上限;每分钟限制仍然适用。

一个重要的架构细节:你的API密钥绑定到特定的Google Cloud项目,该项目的计费账户决定你的等级。如果你有多个项目,每个项目都会独立评估。一个启用计费且消费$300的项目处于Tier 2,而同一Google账户下另一个没有消费的项目仍处于免费版。这意味着团队环境通常需要为每个环境(开发、预生产、生产)配置专用项目,并分别追踪计费。

如何在Google AI Studio创建你的第一个Gemini API密钥

在Google AI Studio创建Gemini API密钥的分步指南及安全最佳实践
在Google AI Studio创建Gemini API密钥的分步指南及安全最佳实践

创建Gemini API密钥不到五分钟,只需一个Google账户。整个过程完全通过Google AI Studio进行,这是Google面向开发者的Gemini API界面。你不需要访问Google Cloud Console来获取第一个密钥——只有当你想要应用安全限制或管理计费门槛时才需要。

首先访问Google AI Studio,地址为aistudio.google.com。用你的Google账户登录。你会进入AI Studio主界面,显示最近的提示和模型操作台。在左侧边栏,你会在顶部附近找到"获取API密钥"链接,点击它。如果看不到边栏,找左上角的菜单图标,或直接访问aistudio.google.com/apikey。

在API密钥页面,你会看到之前创建的所有密钥,以及它们所属的Google Cloud项目。点击右上角的"创建API密钥"按钮。会弹出一个对话框,要求你选择Google Cloud项目。如果你已经有项目,从下拉菜单中选择。如果是全新开始,选择"在新项目中创建API密钥"——Google会自动创建一个名为"我的第一个项目"之类的项目。

确认后,Google生成你的API密钥并在对话框中显示。立即复制此密钥并安全存储——关闭对话框后,Google将永远不会再次显示完整的密钥。如果丢失,你需要删除旧密钥并创建新的。常见的存储方式包括环境变量(本地开发最安全)、生产环境的密钥管理器(如AWS Secrets Manager或HashiCorp Vault),或者添加到.gitignore.env文件。绝对不要在源代码中硬编码API密钥或将其提交到版本控制系统。

复制密钥后,可以立即使用简单的curl请求或Python SDK进行测试:

bash
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=YOUR_API_KEY" \ -H 'Content-Type: application/json' \ -X POST \ -d '{"contents": [{"parts": [{"text": "你好"}]}]}'

成功的响应返回包含模型回复的JSON对象。如果看到400 API key not valid错误,检查密钥是否完整复制——API密钥区分大小写,包含字母和数字。在此阶段出现429 RESOURCE_EXHAUSTED错误通常意味着免费版配额已用完,可在Google AI Studio配额仪表板中验证。

你的新密钥自动以免费版开始。可以立即用于开发、实验以及15 RPM限制足够的应用。对于大多数构建个人项目或原型的独立开发者,免费版可以处理中等工作量,无需任何费用。

升级至Tier 1——启用计费即时获得访问权限

Tier 1是第一个付费等级,升级过程比大多数开发者预期的要简单。唯一的要求是在API密钥所属的Google Cloud项目上启用计费。没有消费门槛,没有等待期,也没有申请流程。一旦你的项目绑定了有效的支付方式,API密钥的速率限制立即提升。

计费设置在Google Cloud Console中进行,而非AI Studio。访问console.cloud.google.com,确保查看的是正确的项目——项目选择器下拉菜单在顶部导航栏中。前往左侧边栏的"计费",点击"关联计费账户"。如果你已经有其他Google服务的Google Cloud计费账户,可以关联该现有账户。否则,系统会提示你通过输入信用卡或银行账户来创建新的计费账户。

关联计费账户后,返回AI Studio的aistudio.google.com/apikey页面。你的现有API密钥不会改变——同一个密钥现在以Tier 1配额运行。你可以通过检查配额页面或运行高并发测试来验证升级是否成功:如果每分钟可以发送超过15个请求而不触发429错误,则等级升级成功。

在Tier 1使用Gemini与免费版的成本差异不在于订阅费——Google按消耗的token收费。Gemini 2.0 Flash输入token每百万$0.075,输出token每百万$0.30(Google AI Studio定价页面,2026年3月)。轻度使用每月账单不过几美元甚至更少。你只为使用的部分付费,启用计费没有基础费用。在Google Cloud Console中设置计费提醒是个好习惯:前往计费 > 预算和提醒,创建一个你能接受的阈值提醒,例如$10或$50。

一个常见问题是:Google Cloud的免费试用额度是否算作Tier 1的"启用计费"?答案是肯定的——如果你的项目绑定了计费账户(即使该账户仍有免费试用额度),你的API密钥就以Tier 1运行。区别在Tier 2和Tier 3中体现,那里的$250和$1,000门槛基于实际向支付方式收取的费用,而非额度消耗。

启用计费并确认Tier 1访问后,还应该了解配额增加申请流程。Google Cloud Console允许你为特定模型申请超出默认Tier 1限制的更高配额。在Google Cloud Console中进入APIs & Services > Quotas,按"Generative Language API"筛选,即可提交特定配额维度的增加申请。关于提高配额的完整指南,请参阅如何提高Gemini API配额

升级至Tier 2——$250累计消费要求

Tier 2是最让开发者感到意外的等级,因为升级路径涉及一个特定的实际API消费金额,这在Google文档中并不明显。要升级到Tier 2,你的Google Cloud项目必须有累计$250或以上的真实API消费,且计费账户活跃满至少30天。两个条件必须同时满足。

最关键的注意事项是关于什么算入$250门槛。Google Cloud为新账户提供的$300免费试用额度不计入。推广额度、推荐奖励额度以及任何形式的免费赠送额度均不计入。只有真实消费——即额度耗尽后向实际支付方式收取的金额——才会累计到等级升级门槛。这一区别导致了大量困惑,因为$300免费试用使得在Cloud Console界面上消费数百"美元"却没有真实资金转移的情况很容易发生。

计算到达$250的实际路径:以Gemini 2.0 Flash定价($0.075/百万输入token,$0.30/百万输出token),需要相当大的使用量才能达到$250。一个典型的聊天机器人应用,每天处理1,000次对话,每次500个输入token和200个输出token,每天产生约$0.20的API费用——这意味着需要超过三年才能有机地达到$250。对大多数开发者来说,实际升级到Tier 2的途径要么是真正的高并发生产工作负载,要么是有意运行使用密集型任务来加速消费。

有些开发者使用Gemini 2.5 Pro或其他更高成本的模型来更快达到门槛。Gemini 2.5 Pro每个token的成本比Flash高得多,因此处理大量文本通过Pro模型可以更快地积累消费。然而,这只有在你真正需要那些功能的情况下才有意义。纯粹为了达到Tier 2而运行人为负载测试是低效的;如果你需要立即为生产部署获得Tier 2,联系Google Cloud销售团队讨论你的使用案例通常更实际。

30天的要求从你首次在项目上启用计费之日算起,与消费无关。这意味着你今天启用计费,即使你以某种方式在一天内花了$250,明天也无法获得Tier 2访问权限。两个条件——真实消费$250并且计费历史满30天——必须同时满足。Google的系统通常会自动监控等级门槛;没有手动审批流程或需要提交的申请。一旦两个门槛都达到,速率限制会自动更新。

对于需要Tier 2吞吐量但不满足消费要求的开发者,一些第三方API聚合服务提供更高速率限制的Gemini模型访问。例如,laozhang.ai以具有竞争力的per-token定价聚合包括Gemini在内的多个AI模型,没有等级限制系统——对于在有机达到Tier 2消费之前需要更高吞吐量的团队来说是个实用选择。

Tier 3和企业级访问

Tier 3是通过标准Google Cloud计费系统可获得的最高自助服务等级。要求是你的Google Cloud项目累计真实API消费$1,000,同样适用关于额度不计入的注意事项。在Tier 3,你可以获得所有Gemini模型最高的默认配额,包括计算成本最高的模型。

Tier 3的速率限制因具体模型而异。对于Gemini 2.0 Flash,Tier 3提供2,000 RPM或更高。对于Gemini 1.5 Pro和Gemini 2.5 Pro,与Tier 2相比,Tier 3解锁了显著提升的吞吐量。具体数字因模型版本而异,随着Google更新基础设施也会变化,因此请始终在Google Cloud Console配额页面验证当前限制,而不是依赖静态文档。

对于超出Tier 3配额的工作负载,Google提供额外的配额增加申请,可以突破标准限制。通过Google Cloud Console的配额增加申请系统提交,附上业务理由。对于非常高并发的使用案例——每天处理数百万请求的应用——Google建议与企业销售团队接触。企业协议可以包括自定义速率限制、专用基础设施选项、SLA保证以及无法通过标准计费路径获得的定价谈判。

API密钥安全——设置权限和限制

API密钥安全限制设置,展示IP地址、HTTP引用来源和API服务限制配置
API密钥安全限制设置,展示IP地址、HTTP引用来源和API服务限制配置

Gemini API密钥的安全配置在Google Cloud Console中进行,这是Gemini开发者体验中文档最不完善的方面之一。不受限制的API密钥可以被任何获取它的人使用,从任何IP地址,调用你项目上启用的任何Google API。设置限制将通用凭证转变为范围狭窄的令牌,大幅降低滥用风险。

Google Cloud Console提供三种类型的API密钥限制,可以同时应用多种限制。访问console.cloud.google.com,选择你的项目,前往APIs & Services > Credentials,点击你的API密钥,然后点击"编辑API密钥"访问限制设置。

IP地址限制允许你指定一个或多个IPv4或IPv6地址或CIDR范围,API密钥将只接受来自这些地址的请求。这非常适合运行在已知基础设施上的服务端应用——如果你的应用服务器总是从固定IP地址发出Gemini API调用(在云虚拟机、具有静态出口IP的Kubernetes集群或企业网络中很常见),你可以将密钥限制为该IP。以标准记法或CIDR格式输入IP(例如,单个IP用203.0.113.42,子网用10.0.0.0/24)。任何来自不在列表上的IP的请求都会收到403 IP_ADDRESS_NOT_IN_WHITELIST错误。

HTTP引用来源限制允许你指定哪些网站域名可以使用API密钥。这是为从浏览器直接调用API的客户端JavaScript代码设计的。将你的域名指定为https://yourdomain.com/*以允许所有页面,或https://yourdomain.com/specific-path/*只允许部分路径。该限制检 查Referer HTTP头——注意这比IP限制弱,因为Referer头可以被伪造,但仍然对随意滥用提供了有意义的屏障。

API限制限制你的密钥可以调用哪些Google API。默认情况下,新创建的密钥可以调用你项目上启用的任何Google API。如果你的应用只使用Gemini API,应该将密钥特别限制为"Generative Language API"。这意味着即使有人获得了你的密钥,他们也无法用它访问Google Maps、Google Drive或你在同一项目上启用的其他API。要配置这一点,在"API限制"下选择"限制密钥",然后从可用API列表中选择"Generative Language API"。

最安全的配置是结合以上三种限制类型:限制到你应用的IP范围(或特定IP),如果有网页前端则设置引用来源到你的域名,并将API范围限制为只有Generative Language API。对于生产应用,这三层方法意味着即使密钥泄露,攻击者也能获得的价值极小。他们需要在你的IP范围内,以正确的Referer头发送请求,且只能调用一个特定的API。

定期轮换API密钥也是良好实践,特别是对于长期运行的应用。Google使轮换变得简单:创建一个新的受限密钥,更新应用的环境变量使用新密钥,验证新密钥在生产中正常工作,然后删除旧密钥。整个过程大约需要十分钟,显著降低了旧密钥曾经意外暴露的风险窗口。

地区可用性和地理限制

Gemini API对大多数用户来说是全球可用的,但某些地区的开发者面临访问限制,影响免费和付费版本。Google的Gemini API在中国大陆不可访问,某些其他市场的用户可能发现某些模型功能不可用,或者由于路由路径导致延迟显著更高。

对于在中国大陆的开发者,网络层面的限制阻止了对aistudio.google.com和Gemini API端点generativelanguage.googleapis.com的直接访问。典型的解决方案是将应用部署在中国境外的云基础设施上(如AWS新加坡、Azure日本东部或Google Cloud香港),或使用通过不受限网络路由请求的API代理服务。

对于某些欧洲地区的开发者,数据驻留要求影响了他们使用标准Gemini API端点的方式。Google Vertex AI(Google的企业AI平台)提供具有可配置数据驻留选项(欧盟、美国等)的Gemini模型,对于有严格数据治理要求的企业来说通常是正确的选择。Vertex AI版本的Gemini使用基于服务账户的OAuth认证而非API密钥,涉及不同的定价结构,需要不同的集成方式——但为某些组织提供了所需的区域控制。

对于需要Gemini功能但无法绕过地区限制的开发者,API聚合服务如laozhang.ai提供通过自有代理基础设施的Gemini模型访问,可以从Google API被封锁或直接延迟过高的地区访问。这些服务通常镜像OpenAI API格式,对于已经熟悉该接口的开发者来说集成非常简单。更多直接Google API访问受限时的替代选项,请参阅无速率限制的Gemini API替代方案指南

常见问题排查

在使用Gemini API等级系统时,开发者会遇到一套可预测的问题,从计费配置问题到速率限制错误。一旦理解了根本原因,大多数问题都有简单的解决方案。

计费被拒或信用卡被拒:如果你尝试启用计费但支付方式被拒,验证你的卡是否支持国际收费,以及账单地址是否与卡的记录匹配。Google Cloud以美元计费,部分非美国卡有外汇交易限制会触发拒绝。在许多地区,Google Pay和PayPal被支持为计费替代方案。如果你的卡反复被拒,联系发卡行将Google LLC列为白名单商户通常能解决问题。

启用计费后Tier 1未激活:关联计费账户后,等级升级通常在几分钟内生效。如果10-15分钟后仍然看到免费版速率限制,在Google Cloud Console中验证计费账户是否真的关联到正确的项目——而不只是你的账户。前往控制台 > 计费 > 我的项目,确认目标项目出现且计费已启用。同时检查你的API密钥是否关联了该项目(在AI Studio的API密钥页面可以看到每个密钥的项目名称)。

速率限制错误(429 RESOURCE_EXHAUSTED):这是开发中最常见的错误。免费版遇到429意味着超出了15 RPM或1,500 RPD的限制。Tier 1的429错误通常表示突发流量超过每分钟限制,而非每日上限问题。标准缓解方案是指数退避:等待1秒重试;如果再次失败,等2秒,然后4秒,再8秒,直到最大值。对于Tier 1持续出现429错误,检查是否使用了配额限制最严格的模型变体——同一等级内某些模型变体的限制低于其他模型。关于Gemini API 429速率限制错误修复的详细指南涵盖了包括请求队列和多密钥设置在内的高级缓解策略。

添加限制后API密钥返回403错误:如果你最近添加了IP或HTTP引用来源限制,现在看到403错误,最常见的原因是你配置的限制与实际请求来源不匹配。对于IP限制,使用ifconfig.io或checkip.amazonaws.com等服务验证你的应用出站IP——云基础设施通常有不同的内部和外部IP,你以为的IP可能与Google看到的不一致。对于HTTP引用来源限制,检查你的应用发送的Referer头是否与你配置的模式精确匹配,包括协议(http还是https)和尾部通配符。

Tier 2或Tier 3升级缓慢:如果你认为已经超过了$250或$1,000的消费门槛但没有看到等级升级,首先在Google Cloud Console > 计费 > 报告中验证你的消费。按"Generative Language API"筛选只查看Gemini相关费用。记住,额度会减少你的有效消费——如果计费报告显示总使用量$300,但$200由推广额度覆盖,则只有$100计入等级门槛。同时验证计费账户活跃时间是否满30天。等级升级是自动的,但在超过门槛后可能需要最多24小时才能生效。

常见问答

Q:我可以用Google Cloud的$300免费试用额度达到Tier 2吗?

不行。Google为新Google Cloud账户提供的$300免费试用额度不计入$250或$1,000的等级升级门槛。Google基于额度耗尽后向实际支付方式处理的真实费用来追踪等级资格。这是关于Gemini API等级系统最常见的误解之一。如果你将所有$300免费试用额度都用于Gemini API使用,你的项目计费报告将显示$300的使用量,但等级升级追踪器将显示$0的合格消费。

Q:如果我创建新API密钥,即使我的项目已经是Tier 2,它还是从免费版开始吗?

不会。API密钥继承其所属项目的等级。如果你的项目符合Tier 2资格(意味着项目的计费账户已越过$250真实消费门槛,且计费历史满30天),那么你在该项目中创建的任何API密钥——无论是新密钥还是现有密钥——都以Tier 2运行。等级是项目的属性,而非单个密钥的属性。

Q:同一项目上可以有多个API密钥,它们共享速率限制配额吗?

是的,速率限制在项目级别跨所有API密钥共享。如果你的项目对Gemini 2.0 Flash有150 RPM的限制,且你有三个密钥同时发出请求,三个密钥的合计总量不能超过150 RPM。这种架构是故意设计的——它防止通过密钥增殖来绕过等级限制。要获得更高吞吐量,需要更高等级(更多消费)或配额增加申请,而非更多密钥。

Q:越过门槛后,Tier 2或Tier 3需要多长时间才能激活?

Google的系统会自动监控等级门槛,通常在越过消费要求后几小时内升级你的项目等级。某些情况下可能需要长达24小时。没有手动触发器或需要提交的申请。你可以通过在Google Cloud Console > APIs & Services > Quotas > Generative Language API中检查配额限制来监控当前等级。

Q:有没有不测试速率限制就能验证当前等级的方法?

有。在Google Cloud Console中,前往APIs & Services > Quotas,按"Generative Language API"筛选。显示的配额值对应你的当前等级。例如,如果"每分钟每项目生成内容请求数"对Gemini 2.0 Flash显示为15,你在免费版。如果显示150或更高,你在Tier 1或以上。这比在测试期间从速率限制行为推断等级更可靠。

开始:你的下一步

理解Gemini API等级系统,使你从一开始就能对应用架构和成本规划做出明智决策。免费版对于学习、原型设计和低并发应用来说非常实用——15 RPM和1,500次每日请求比许多开发者预期的能处理更多工作负载。Tier 1只需要一个计费账户,并以按使用付费的方式提供10倍的速率限制提升,在中等规模下成本保持实惠。

对于计划生产部署的团队,实用建议是立即启用计费(即使还没有大量流量),以便开始30天Tier 2资格的计时。从第一天起就为API密钥配置适当的限制——服务端应用使用IP限制,任何前端组件使用HTTP引用来源限制,所有密钥使用Generative Language API的API范围限制。这些做法只需10分钟设置,随着应用规模扩展显著降低安全风险。

等级升级路径需要真实使用而非额度,这意味着API使用量的可持续有机增长是向每个等级自然递进的过程。在成本模型中提前规划这一点而非被其意外打到的团队,能更自信地随着应用增长逐级扩展。

Nano Banana Pro

4K图像官方2折

Google Gemini 3 Pro Image · AI图像生成

已服务 10万+ 开发者
$0.24/张
$0.05/张
限时特惠·企业级稳定·支付宝/微信支付
Gemini 3
原生模型
国内直连
20ms延迟
4K超清
2048px
30s出图
极速响应
|@laozhang_cn|送$0.05

200+ AI 模型 API

2026.01
GPT-5.2Claude 4.5Gemini 3Grok 4+195
图像
官方2折
gemini-3-pro-image$0.05

GPT-Image-1.5 · Flux

视频
官方2折
Veo3 · Sora2$0.15/次
省16%5分钟接入📊 99.9% SLA👥 10万+用户