Gemini API 限流主要由 RPM 和 TPM 配额触发,需通过 Cloud Console 查看配额、启用指数退避、压缩请求内容、切换区域端点来应对。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在使用 Gemini 的 API 时遇到请求被拒绝、响应延迟或返回 429 状态码,很可能是触发了其内置的速率与配额限制。以下是理解并应对这些限制的关键操作步骤:
一、了解每分钟请求数(RPM)限制
Gemini API 对每个 API 密钥设定了每分钟允许发起的请求数上限,超出后将直接拒绝后续请求。该限制与项目层级的配额绑定,且不同模型版本(如 gemini-1.5-flash、gemini-1.5-pro)具有独立 RPM 值。
1、登录 Google Cloud Console,进入对应项目。
2、导航至“API 和服务” > “配额”页面。
3、在服务筛选栏中选择“Gemini API”,查找指标为“Requests per minute per project”的配额行。
4、确认当前使用量与硬性上限值,注意:免费层默认 RPM 通常为 60,超出需提交配额提升申请。
二、识别每分钟令牌数(TPM)限制
除请求数外,Gemini 还按输入与输出总令牌数进行限流。TPM 限制作用于整个项目,涵盖所有调用模型的请求,尤其影响长上下文或批量生成场景。
1、在相同“配额”页面中,查找指标为“Tokens per minute per project”的条目。
2、使用 Google Cloud 的“API 使用情况”报告,导出近 24 小时内各请求的 prompt_token_count 与 candidates_token_count 字段。
3、累加每分钟所有请求的 token 总和,与 TPM 配额比对,若单次请求输入超 8192 tokens,可能立即触发 TPM 拒绝,即使 RPM 未达上限。
三、启用指数退避重试机制
当收到 HTTP 429 响应时,强制等待固定时间会导致资源浪费;采用带随机抖动的指数退避策略可显著降低重试冲突概率,并提升整体吞吐成功率。
1、捕获响应状态码,判断是否为 429 或部分 503。
使用AIsa生成图像与视频。仅需一个API密钥即可调用Gemini 3 Pro Image(图像)和Qwen Wan 2.6(视频)。
2、解析响应头中的 Retry-After 字段,若存在则优先采用其建议秒数。
3、若无 Retry-After,则计算基础等待时间:2^attempt × 100ms,再叠加 0–100ms 随机抖动。
4、最大重试次数不得超过 5 次,且第 5 次等待时间不可超过 30 秒。
四、实施请求批处理与内容压缩
将多个语义独立的小请求合并为单次多候选(multi-candidate)调用虽不被 Gemini 原生支持,但可通过结构化 prompt 设计模拟批量意图,同时精简输入文本可直接减少 token 占用。
1、对同类任务(如批量提取地址),改用 JSON 格式封装多条记录于 single prompt 中,并指示模型以数组格式输出。
2、移除输入中的冗余空格、换行符及重复说明语句,使用缩写替代长术语(如将“artificial intelligence”替换为“AI”)。
3、对图像类请求,预处理图片为符合 Gemini 支持的最大尺寸(如 2048×2048)与 WebP 格式,避免上传原始高分辨率 PNG 导致 base64 编码后 token 暴增。
五、切换至区域化端点并校验地理位置路由
Gemini API 的全球端点(generativelanguage.googleapis.com)存在统一配额池,而部分区域端点(如 us-central1-generativelanguage.googleapis.com)拥有独立配额,且网络延迟更低。
1、在 Google Cloud 控制台中确认项目已启用对应区域的 Gemini API(例如 us-central1)。
2、将请求 URL 中的域名由 generativelanguage.googleapis.com 替换为
3、使用 curl -v 测试新端点的 DNS 解析 IP 是否归属目标区域,若解析结果仍指向 global 任播地址,则需检查 VPC 网络出口策略或启用 Private Google Access。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










