Gemini 图片生成 429 速率限制：先分清每分钟、每日和花费上限

Gemini 图片模型（Nano Banana 2 Lite、Nano Banana 2、Nano Banana Pro）返回 HTTP 429 或 RESOURCE_EXHAUSTED，意思是这个项目的某一项限额用完了，不是模型坏了。先排除最常见的一种：截至 2026 年 10 月 4 日，这三个图片模型在 Google 定价页的免费层一栏都是“Not available”，图片输出没有免费额度。没开结算的项目调用图片模型，报的 429 往往带着 limit: 0，等多久都不会恢复。

项目已经付费，再看是哪一种限额：每分钟限额靠指数退避加抖动就能过去；每日配额要等太平洋时间午夜重置或申请提额；按花费计算的 10 分钟上限（Tier 1 是 $10）要降低出图速度。重试只对这几种临时错误有用，402、403、400 重试多少次都不会成功。

是哪一种 429：五种情况的诊断表

先拿到完整的错误响应。用 Interactions API 时，错误里的 code 字段直接给出类型：rate_limit_exceeded 是每分钟或每秒限额，quota_exceeded 是每日配额，too_many_requests 是短时间内请求过多（见 Google 的 API 错误代码表）。用 generateContent 时只会看到 429 RESOURCE_EXHAUSTED，需要读 message 里写的配额名称和数值，再对照 AI Studio 里该项目的用量。

如果拿到的根本不是 429，而是 402（预付余额用完）、403（Key 没有权限）或 503（服务过载），处理方法见文末“不是 429 但常被混在一起”一节。

免费层项目调用图片模型：limit 0 不是额度用完，是本来没有

图片输出只在付费层提供。Gemini API 免费层的 Key 可以调用文本模型，但调用 gemini-3.1-flash-lite-image、gemini-3.1-flash-image 或 gemini-3-pro-image 时会在配额检查上失败；开发者常见的报错里带有 generate_content_free_tier_requests 和 limit: 0。这里的 0 就是该项目对这个模型的额度，不会在午夜后变多。

处理方法只有一个方向：在 AI Studio 给项目开通结算。新用户默认是预付模式，至少充值 $5，余额用完时请求返回 402，不是 429（见 Gemini API 结算说明）。Google Cloud 的 $300 免费试用赠金不能用于 Gemini API。

已经付费、错误里却仍然写着 free tier 和 limit 0，多半是运行中的 Key 不属于付费项目，排查步骤见已付费仍报 free_tier_requests limit 0 的处理方法。只想免费出几张图、不需要 API 的话，Gemini 应用等入口的次数见 Gemini 免费生图次数说明。

还有一个前提：Gemini API 和 AI Studio 的可用地区名单不包括中国大陆和香港，这类账号与地区问题不在 429 的处理范围内。

每分钟限额（RPM、IPM）触发的 429：退避加抖动

Gemini API 的限额从几个维度同时计算：每分钟请求数 RPM、每分钟输入 token 数 TPM、每日请求数 RPD，图片模型还多一项每分钟图片数 IPM。任何一项超了都会报 429，哪怕其他几项还有余量（见 Gemini API 速率限制文档）。当前图片模型各层级的 RPM、IPM 数值，文档没有列出，只在 AI Studio 里该项目的速率限制页面显示，而且会随层级和账号状态变化；带“Tier 1 每分钟 10 张”这类固定数字的表格都不是 Google 公布的数据。

每分钟限额是暂时的，正确做法是等一下再试，而且每次等得更久。Google 的问题排查指南给的规则是：

• 第一次重试前等约 1 秒，之后按 2、4、8 秒指数增加；
• 在延迟上加随机抖动，避免所有客户端同时重试；
• 只重试临时错误（429、408、5xx），400、402、403 不重试；
• 设置最大重试次数。

用 Python SDK 时，先确认重试有没有打开。 Google 的排查指南写的是 Python SDK 默认对 429 和 5xx 自动重试最多 4 次，初始延迟约 1 秒、最长 60 秒。但用截至 2026 年 10 月 5 日的最新版 google-genai 2.28.0 对一个固定返回 429 的本地服务测试，结果是：默认的 genai.Client() 只发一次请求就抛出 APIError；显式传入 HttpRetryOptions 后才会重试，共发出 5 次请求，延迟从约 1 秒指数增长、封顶 60 秒，重试的状态码包括 408、429、500、502、503、504。以上是 client.models.generate_content 的行为；同版本的 client.interactions.create 默认会自己重试 429（约 3 秒内 4 次请求）。JS、Go、Java SDK 没有做同样的测试。所以用 google-genai 时直接显式开启：

from google import genai
from google.genai import types

client = genai.Client(
    http_options=types.HttpOptions(retry_options=types.HttpRetryOptions())
)

HttpRetryOptions 还可以设置 attempts（含首次请求的总次数）、initial_delay、max_delay、jitter 等字段。开启后 SDK 再抛出 429，说明它已经重试过一轮，这时在外面再套一个立即重试的循环只会更快耗尽限额，该做的是降低并发。

直接调 REST 接口时需要自己写。下面是一段最小实现，请求体与 Google 图片生成指南的 Interactions 示例一致：

import os
import random
import time

import requests

URL = "https://generativelanguage.googleapis.com/v1beta/interactions"
RETRYABLE = {408, 429, 500, 502, 503, 504}


def create_image(prompt, model="gemini-3.1-flash-image", max_retries=5):
    headers = {"x-goog-api-key": os.environ["GEMINI_API_KEY"]}
    body = {"model": model, "input": [{"type": "text", "text": prompt}]}
    for attempt in range(max_retries + 1):
        resp = requests.post(URL, headers=headers, json=body, timeout=180)
        if resp.status_code not in RETRYABLE:
            resp.raise_for_status()  # 400/402/403 等直接报错，不重试
            return resp.json()
        if attempt == max_retries:
            break
        delay = min(60, 2 ** attempt) + random.uniform(0, 1)  # 1, 2, 4, 8... 秒，加抖动，封顶 60 秒
        time.sleep(delay)
    resp.raise_for_status()

这段代码只用模拟的响应测试过重试分支：先 429、再 503、再 200 时等待两次后返回；遇到 402 立即报错不等待；连续 429 时按设定次数放弃。它没有调用真实接口。返回的 JSON 里如何取出图片，按 Gemini 图片 API 调用教程处理。

还要注意两点。失败的 400 和 500 请求不收费，但同样计入配额，所以无节制的重试本身就会把限额推得更满。另外，如果用的是 Priority 通道，它的默认限额只有标准限额的 0.3 倍。需要恢复中断的 Nano Banana Pro 批量任务、跳过已完成的图片，参考 Nano Banana Pro RESOURCE_EXHAUSTED 恢复代码。

每日配额（RPD）触发的 429：等太平洋时间午夜重置

每日请求数在太平洋时间午夜重置。换成北京时间：夏令时期间太平洋时间是 UTC−7，北京是 UTC+8，相差 15 小时，所以重置发生在北京时间 15:00；2026 年 11 月 1 日夏令时结束后变成 UTC−8，相差 16 小时，重置时间改为北京时间 16:00。

每日配额用完时，退避重试没有意义，整天都会失败。能做的有三件事：等重置；把当天剩下的任务改用 Batch API 提交（它的限额与普通调用分开，见后文）；或者在 Google 的速率限制文档里提交付费层提额申请，Google 不保证一定提高。

Tier 1 每 10 分钟 $10：花费上限折合多少张图

除了 RPM、TPM 这类按次数计的限额，Gemini API 还有一项按花费计算的限额，在滚动的 10 分钟窗口里统计：免费层不适用，Tier 1 是 $10，Tier 2 是 $50，Tier 3 是 $200。触发时同样返回 429 RESOURCE_EXHAUSTED。这项限额是否作用于你的账号，取决于账单历史和账号状况，所以有的项目从来碰不到，有的项目 RPM 远没满就开始报错。

图片越贵，越快碰到这个上限。按 Google 定价页的 token 单价换算每张图的价格（截至 2026 年 10 月 4 日，标准模式）：

• Nano Banana Pro 1K/2K：1,120 个 token × $120 / 100 万 = $0.1344（定价页显示为 $0.134）
• Nano Banana Pro 4K：2,000 × $120 / 100 万 = $0.24
• Nano Banana 2 1K：1,120 × $60 / 100 万 = $0.0672（定价页显示为 $0.067）
• Nano Banana 2 2K：1,680 × $60 / 100 万 = $0.1008（定价页显示为 $0.101）
• Nano Banana 2 Lite 1K：1,120 × $30 / 100 万 = $0.0336

每 10 分钟最多能出的张数 = 该层级的花费上限 ÷ 每张价格，结果向下取整：

举例：Tier 1 项目用 Nano Banana Pro 出 2K 图，$10 ÷ $0.1344 = 74.4，10 分钟内大约第 75 张就会撞上限，平均下来每分钟不到 7.5 张。这些张数只算图片输出，没有算提示词、参考图等输入 token，也没有算 Pro 默认开启并计费的思考 token，实际能出的张数会更少。

碰到花费上限时，Google 建议稍等再试、降低高成本请求的频率；正常使用下持续触发，再申请提额。出图任务可以拆得更平均，或者把不需要 Pro 的部分换成 Nano Banana 2。

限额按项目算：多开 API Key 不会增加额度

速率限制按项目计算，不按 API Key 计算。同一个项目下建 10 个 Key 轮流用，它们共享同一份 RPM、IPM、RPD 和花费上限，429 一样会出现。

反过来，Key 用错项目也会制造 429：在 AI Studio 里看到的 Tier 1 是 A 项目，而服务器上的环境变量还是 B 项目（免费层）的 Key，报错就会是免费层的 limit 0。排查时以失败请求实际使用的 Key 为准，在 AI Studio 的项目页面确认它所属项目的层级。

用量层级怎么升：Tier 2 要累计付款 $100 并满 3 天

层级决定限额高低。截至 2026 年 10 月 5 日，Google 的速率限制文档写的条件是：

几个细节会影响你的判断：

• Tier 2、Tier 3 的累计付款按项目所关联的结算账号在 Google Cloud 上的全部花费计算，不只是 Gemini API。
• 从免费层升到 Tier 1 通常在开通结算后立即生效，之后的升级在 10 分钟内生效。
• 满足条件一般就会升级，但 Google 写明在少数情况下升级申请会被拒绝。

各层级下每个模型的 RPM、IPM、RPD 具体数值，仍然只看 AI Studio。文本模型的限额维度和服务通道，见 Gemini API 速率限制排查。

限额长期不够：Batch、换模型还是按次付费

如果 429 不是偶发，而是每天的出图量本来就超过当前层级，退避只能把失败推后。可以按是否需要立即拿到图来选：

• 不急着要结果：用 Batch API。 Batch 的速率限制与普通调用分开计算，价格是标准价的 50%（Pro 1K/2K 每张 $0.067，4K 每张 $0.12），目标是 24 小时内完成，多数情况更快。成本算法见 Nano Banana Pro Batch API 成本。
• 需要实时出图：换更便宜的模型或尺寸。 同样 $10 的花费上限，Nano Banana 2 1K 能出 148 张，Pro 2K 只有 74 张；不需要 Pro 的画面质量时，换模型能直接把上限翻倍。
• 持续需要更高容量： 累计付款满足 Tier 2 条件，或提交提额申请。
• 需要按次计费的付费备选： LaoZhang API 的公开价格（截至 2026 年 9 月 24 日）是 gemini-3-pro-image 每次调用 $0.09（1K、2K、4K 同价）、gemini-3.1-flash-image 每次 $0.055；返回 HTTP 200 但没有图片也按一次计费。它转发到 Google 的模型，安全过滤照旧，使用量受该平台自己的规则约束，是一份独立的付费合同，而不是 Google 免费层的替代。按单价比较，Pro 4K 时 $0.09 低于官方标准价 $0.24，Pro 1K/2K 时官方 Batch 的 $0.067 更便宜。

说明：laozhang.ai 是我们自己的服务，其价格是平台报价，不是独立比较的结论。

Vertex AI（Gemini Enterprise Agent Platform）上的 429：共享容量不够

在 Google Cloud 的 Vertex AI（现在的文档名称是 Gemini Enterprise Agent Platform）上调用 Gemini 图片模型，429 的含义不同：随用随付模式下没有给你预留容量，请求量超过当时可分配的共享容量就会返回 Resource exhausted, please try again later.。Google 的建议是尽量使用全球端点而不是区域端点、用截断指数退避重试、平滑流量避免尖峰、用量需要逐步增加；需要稳定容量时购买预配吞吐量（Provisioned Throughput），超出部分按随用随付处理。详见 Google Cloud 错误代码 429 文档。上文 AI Studio 的层级和花费上限不适用于这条路线。

不是 429 但常被混在一起：402、503 与 Gemini CLI

• 402：预付余额用完。Google 明确写“不要重试”，充值或开启自动充值后才会恢复。
• 403：Key 没有访问该资源的权限，检查 Key 和项目。
• 503：服务端暂时过载或宕机，与你的限额无关，同样用退避处理。图片模型的 503 和“高需求”提示，分别见 Nano Banana Pro 503 排查和 Gemini 高需求错误的判断方法。
• Gemini CLI 报 429：CLI 用的是自己的额度规则，上面的项目层级和花费上限不能直接套用。

报错类型很多、一时分不清是哪一类时，可以先按 Gemini 图片生成错误修复对照错误码。

常见问题

Gemini 429 错误要等多久才能恢复？

取决于是哪种限额。每分钟限额通常等几秒到一分钟、按退避重试就能恢复；花费上限在滚动 10 分钟窗口里统计，降低速度后会逐渐恢复；每日配额要等太平洋时间午夜，也就是北京时间 15:00（夏令时）或 16:00（冬令时）；免费层的 limit 0 不会自己恢复，必须开通结算。

Gemini API 免费额度还能生成图片吗？

不能。截至 2026 年 10 月 4 日，Nano Banana 2 Lite、Nano Banana 2 和 Nano Banana Pro 的图片输出都没有免费层，免费 Key 调用图片模型会报 429。付费后最便宜的是 Nano Banana 2 Lite，每张 $0.0336，详见 Gemini 图片生成 API 免费说明。

同一个项目建多个 API Key 能绕开 429 吗？

不能。限额按项目计算，同一项目里的所有 Key 共享同一份额度。要更高的限额，只能升级层级、申请提额，或者把任务交给限额独立的 Batch API。