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。
