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

> Gemini 图片模型没有免费额度，免费层出图直接报 429。付费后的 429 先分清每分钟限额、每日配额和每 10 分钟花费上限，再选退避、等重置或降速。

- URL: https://blog.laozhang.ai/zh/posts/gemini-image-429-rate-limit
- Published: 2026-03-15
- Updated: 2026-10-05
- Author: LaoZhang AI Team (https://blog.laozhang.ai/zh/about)
- Topic: API 接入指南
- Tags: Gemini API, 429 错误, RESOURCE_EXHAUSTED, 速率限制, Nano Banana Pro, Nano Banana 2

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

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

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

先拿到完整的错误响应。用 Interactions API 时，错误里的 `code` 字段直接给出类型：`rate_limit_exceeded` 是每分钟或每秒限额，`quota_exceeded` 是每日配额，`too_many_requests` 是短时间内请求过多（见 [Google 的 API 错误代码表](https://ai.google.dev/gemini-api/docs/api-errors?hl=zh-cn)）。用 generateContent 时只会看到 `429 RESOURCE_EXHAUSTED`，需要读 message 里写的配额名称和数值，再对照 AI Studio 里该项目的用量。

| 你看到的情况 | 实际原因 | 该做什么 | 不要做 |
| --- | --- | --- | --- |
| message 里有 `free_tier`、`limit: 0`，从第一张图就失败 | 项目在免费层，图片模型没有免费额度；或者运行中的 Key 属于另一个没开结算的项目 | 给这个项目开通结算，或把程序换成付费项目的 Key | 换 Key、等待、重试 |
| 突发并发时失败，隔一会儿又能出图 | 每分钟限额：RPM，或图片模型专有的每分钟图片数 IPM | 指数退避加抖动，降低并发 | 无上限地立即重试 |
| 某个时间点之后整天失败，第二天恢复 | 每日请求数 RPD 用完 | 等太平洋时间午夜重置，或申请提额 | 在同一项目里多开 Key |
| 用 Pro 或 4K 连续出图，过了一阵才开始失败，RPM 看起来没满 | 按花费计算的 10 分钟上限（是否生效因账号而异） | 降低出图速度，改用更便宜的尺寸或模型，长期不够再申请提额 | 只加大并发 |
| 本地正常，部署后报 429 | 线上环境变量里的 Key 属于别的项目 | 核对失败请求所用 Key 的项目编号 | 只看浏览器里某个项目显示的层级 |

![根据429响应与项目用量区分免费层、分钟速率、日配额和花费上限](https://blog.laozhang.ai/posts/zh/gemini-image-429-rate-limit/img/diagnostic-flowchart.webp)



如果拿到的根本不是 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 结算说明](https://ai.google.dev/gemini-api/docs/billing?hl=zh-cn)）。Google Cloud 的 $300 免费试用赠金不能用于 Gemini API。

已经付费、错误里却仍然写着 free tier 和 limit 0，多半是运行中的 Key 不属于付费项目，排查步骤见[已付费仍报 free_tier_requests limit 0 的处理方法](https://blog.laozhang.ai/zh/posts/paid-tier-getting-free-tier-requests-limit-0)。只想免费出几张图、不需要 API 的话，Gemini 应用等入口的次数见 [Gemini 免费生图次数说明](https://blog.laozhang.ai/zh/posts/gemini-image-generation-free-limit-2026)。

还有一个前提：Gemini API 和 AI Studio 的[可用地区名单](https://ai.google.dev/gemini-api/docs/available-regions?hl=zh-cn)不包括中国大陆和香港，这类账号与地区问题不在 429 的处理范围内。

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

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

每分钟限额是暂时的，正确做法是等一下再试，而且每次等得更久。Google 的[问题排查指南](https://ai.google.dev/gemini-api/docs/troubleshooting?hl=zh-cn)给的规则是：

- 第一次重试前等约 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 时直接显式开启：

```python
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 示例一致：

```python
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 调用教程](https://blog.laozhang.ai/zh/posts/gemini-image-api-guide-2026)处理。

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

## 每日配额（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 分钟最多能出的张数 = 该层级的花费上限 ÷ 每张价格，结果向下取整：

| 每 10 分钟最多出图数 | Tier 1（$10） | Tier 2（$50） | Tier 3（$200） |
| --- | --- | --- | --- |
| Nano Banana Pro 1K/2K（$0.1344） | 74 | 372 | 1,488 |
| Nano Banana Pro 4K（$0.24） | 41 | 208 | 833 |
| Nano Banana 2 1K（$0.0672） | 148 | 744 | 2,976 |
| Nano Banana 2 2K（$0.1008） | 99 | 496 | 1,984 |
| Nano Banana 2 Lite 1K（$0.0336） | 297 | 1,488 | 5,952 |

举例：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 的[速率限制文档](https://ai.google.dev/gemini-api/docs/rate-limits?hl=zh-cn)写的条件是：

| 层级 | 条件 | 层级账单上限 | 10 分钟花费上限 |
| --- | --- | --- | --- |
| 免费层 | 有效项目或免费试用 | 无 | 不适用 |
| Tier 1 | 设置并关联有效的结算账号 | $250 | $10 |
| Tier 2 | 累计付款 $100，且距首次成功付款满 3 天 | $2,000 | $50 |
| Tier 3 | 累计付款 $1,000，且距首次成功付款满 30 天 | $20,000 至 $100,000 以上 | $200 |

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

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

各层级下每个模型的 RPM、IPM、RPD 具体数值，仍然只看 AI Studio。文本模型的限额维度和服务通道，见 [Gemini API 速率限制排查](https://blog.laozhang.ai/zh/posts/gemini-api-rate-limits-guide)。

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

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

- **不急着要结果：用 Batch API。** Batch 的速率限制与普通调用分开计算，价格是标准价的 50%（Pro 1K/2K 每张 $0.067，4K 每张 $0.12），目标是 24 小时内完成，多数情况更快。成本算法见 [Nano Banana Pro Batch API 成本](https://blog.laozhang.ai/zh/posts/nano-banana-pro-batch-api-cost-optimization)。
- **需要实时出图：换更便宜的模型或尺寸。** 同样 $10 的花费上限，Nano Banana 2 1K 能出 148 张，Pro 2K 只有 74 张；不需要 Pro 的画面质量时，换模型能直接把上限翻倍。
- **持续需要更高容量：** 累计付款满足 Tier 2 条件，或提交提额申请。
- **需要按次计费的付费备选：** [LaoZhang API](https://docs.laozhang.ai/en/api-capabilities/nano-banana-image) 的公开价格（截至 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 是我们自己的服务](https://blog.laozhang.ai/zh/about#laozhang)，其价格是平台报价，不是独立比较的结论。*

![按时效与容量需求比较Batch、换模型、升层级和独立付费网关](https://blog.laozhang.ai/posts/zh/gemini-image-429-rate-limit/img/solution-comparison.webp)



## 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 文档](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/deploy/error-code-429?hl=zh-cn)。上文 AI Studio 的层级和花费上限不适用于这条路线。

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

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

报错类型很多、一时分不清是哪一类时，可以先按 [Gemini 图片生成错误修复](https://blog.laozhang.ai/zh/posts/gemini-image-common-errors-fix)对照错误码。

## 常见问题

### 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 免费说明](https://blog.laozhang.ai/zh/posts/gemini-image-api-free)。

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

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

## 参考来源

本文引用的外部页面，按正文出现顺序排列。最后更新于 2026-10-05。

- [图片输出没有免费额度](https://ai.google.dev/gemini-api/docs/pricing?hl=zh-cn) (ai.google.dev)
- [Google 的 API 错误代码表](https://ai.google.dev/gemini-api/docs/api-errors?hl=zh-cn) (ai.google.dev)
- [Gemini API 结算说明](https://ai.google.dev/gemini-api/docs/billing?hl=zh-cn) (ai.google.dev)
- [可用地区名单](https://ai.google.dev/gemini-api/docs/available-regions?hl=zh-cn) (ai.google.dev)
- [Gemini API 速率限制文档](https://ai.google.dev/gemini-api/docs/rate-limits?hl=zh-cn) (ai.google.dev)
- [问题排查指南](https://ai.google.dev/gemini-api/docs/troubleshooting?hl=zh-cn) (ai.google.dev)
- [Google Cloud 错误代码 429 文档](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/deploy/error-code-429?hl=zh-cn) (docs.cloud.google.com)