429错误表明已达项目RPM速率限制，需立即干预。检查Google Cloud配额页中Requests per minute per project是否满额，免费层默认60；可通过切换低消耗模型、客户端节流或换账号接力缓解；永久提升需绑定支付方式、开启两步验证、关联结算账号并等待3～5分钟生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你调用 Gemini API 时突然收到 429 错误，请求被直接拒绝，既不是密钥失效也不是网络问题，而是服务端已切断本次请求通道——这说明你已撞上当前项目的速率墙，必须立刻干预，否则所有下游功能将停滞。
确认是否真被 RPM 限流
第一步：打开 Google Cloud Console，确保登录的是调用 API 的对应项目。
第二步：进入「API 和服务」→「配额」页面，在服务筛选器中输入 Gemini API，找到指标名为 Requests per minute per project 的那一行。
第三步：重点看「已使用/限制」数值。若显示 60/60、25/25 或接近满额（如 58/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）保持原样，重发请求。
方法二：启用客户端请求节流
在代码中为每次请求添加时间间隔控制：记录上一次调用时间戳，若距今不足 1000ms（即每分钟最多 60 次），则强制 sleep 补足差值。务必用原子计数器或互斥锁保护，否则多线程下会漏控。
方法三：换账号接力调用
注册并配置第二个谷歌账号，在 Google AI Studio 中创建新项目、启用 Gemini API、生成新密钥；将原系统中的密钥轮换为新密钥，即可瞬时获得另一份 60 RPM 免费额度。
永久提升 RPM 配额的操作流程
第一步：绑定支付方式
进入 Google Cloud Console → 左侧导航栏点击「结算」→「管理结算账号」→ 点击「+ 创建结算账号」→ 输入有效信用卡/借记卡信息并完成验证。
第二步：开启两步验证
访问 Google 账户安全中心，在「两步验证」选项中启用，必须完成手机号短信或身份验证器 App 绑定，否则配额提升申请会被拒绝。
第三步：关联项目与结算账号
回到对应项目 → 「结算」→「关联结算账号」→ 从下拉菜单中选择刚创建的付费账号 → 点击「关联」。
【关键前提】必须等待 3～5 分钟，系统完成后台配额重载，新 RPM 值（通常升至 300～3000）才会生效，立即重试仍会返回 429。
第四步：验证配额更新
再次进入「API 和服务」→「配额」页面，刷新后查看 Requests per minute per project 行的「限制」列数值是否已提升，同时检查「已使用」是否开始归零累计。
