429错误是因达到Gemini API每分钟请求数(RPM)硬上限所致;需通过配额页面确认已用/限制值,再用切换模型、客户端节流或换账号等方法临时绕过,或绑定支付方式并启用两步验证后关联结算账号以永久提升配额。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

调用Gemini API时突然返回429错误,所有请求被直接拒绝,既不是密钥失效也不是网络故障,而是你已撞上当前项目的每分钟请求数(RPM)硬性上限,必须立刻干预才能恢复服务。
确认是否真被RPM限流
第一步:打开Google Cloud Console,确保登录的是发起API调用的对应项目。
第二步:进入「API 和服务」→「配额」页面,在服务筛选器中输入“Gemini API”,找到指标名为【Requests per minute per project】的那一行。
第三步:重点看「已使用/限制」数值——若显示60/60、25/25或59/60,就是RPM耗尽的铁证;此时哪怕token数远未超标,请求也会在鉴权前就被拦截。注意:免费层默认RPM就是60,且该值与模型强绑定,gemini-1.5-flash和gemini-2.5-pro-preview-05-06各自拥有独立配额池,不能混用余量。
立即绕过限流的三种方法
方法一:切换低RPM消耗模型
把请求URL中的模型路径从/v1beta/models/gemini-2.5-pro-preview-05-06:generateContent改为/v1beta/models/gemini-1.5-flash:generateContent,其余参数(headers、contents)保持原样,重发请求即可。这一步操作起来很简单,直接改URL路径就行。
方法二:启用客户端请求节流
在代码中为每次请求添加时间间隔控制:记录上一次调用时间戳,若距今不足1000ms(即每分钟最多60次),则强制sleep补足差值。务必用原子计数器或互斥锁保护,否则多线程下会漏控。
方法三:换账号接力调用
注册并配置第二个谷歌账号,在Google AI Studio中创建新项目、启用Gemini API、生成新密钥;将原系统中的密钥轮换为新密钥,即可瞬时获得另一份60 RPM免费额度。
永久提升RPM配额的操作流程
第一步:绑定支付方式
进入Google Cloud Console → 左侧导航栏点击「结算」→「管理结算账号」→ 点击「+ 创建结算账号」→ 输入有效信用卡/借记卡信息并完成验证。
第二步:开启两步验证
访问Google账户安全中心,在「两步验证」选项中启用,必须完成手机号短信或身份验证器App绑定,否则配额提升申请会被拒绝。
第三步:关联结算账号并等待生效
回到Google AI Studio,点击项目右上角头像→「Manage settings」→「Billing」→「Link billing account」,选择刚创建的结算账号。提交后等待【3~5分钟】,配额自动升级,无需人工审核。

















