作者注:深度解析 Nano Banana 2 (Gemini 3.1 Flash Image Preview) 429 錯誤的根因,對比 AI Studio 和 Vertex AI 的 RPD/RPM/IPM 限額,提供 5 種突破限流方案

使用 Nano Banana 2 生圖時頻繁遇到 429 RESOURCE_EXHAUSTED 錯誤?你不是一個人。根據社區反饋,429 錯誤佔 Nano Banana 2 所有報錯的 70% 以上,是開發者面臨的頭號問題。
核心價值:讀完本文,你將徹底理解 429 錯誤的 4 大觸發維度,掌握 5 種實用解決方案,不再被 Google 的限流機制困擾。
Nano Banana 2 429 錯誤的核心原因
429 錯誤的本質是 API 請求超出了 Google 設定的速率限制。Nano Banana 2 的限流體系由 4 個獨立維度組成,任意一個維度觸頂都會觸發 429。
| 限流維度 | 全稱 | 說明 | 重置時間 |
|---|---|---|---|
| RPM | Requests Per Minute | 每分鐘請求數上限 | 滾動 60 秒窗口 |
| TPM | Tokens Per Minute | 每分鐘 Token 吞吐上限 | 滾動 60 秒窗口 |
| RPD | Requests Per Day | 每日請求總量上限 | 太平洋時間午夜重置 |
| IPM | Images Per Minute | 每分鐘圖像生成數上限 | 滾動 60 秒窗口 |
Nano Banana 2 429 錯誤的 Tier 限額詳情
Google 將用戶分爲不同 Tier(層級),每個 Tier 的限額差異巨大。這是導致大量開發者遭遇 429 錯誤的根本原因——大多數開發者停留在 Tier 1,限額極低。
| Tier 層級 | 准入條件 | RPM | TPM | RPD | IPM |
|---|---|---|---|---|---|
| Free | 免費用戶 | 2 | 32K | 50 | 2 |
| Tier 1 | 啓用計費 | 10 | 4M | 1,000 | 10 |
| Tier 2 | 30 天消費 ≥$250 | 30 | 10M | 5,000 | 30 |
| Tier 3 | 30 天消費 ≥$1,000 | 60 | 20M | 10,000 | 60 |
⚠️ 關鍵信息:Nano Banana 2 沒有免費額度。即使是 Free Tier 用戶也需要啓用計費才能正常使用圖像生成功能。
AI Studio 和 Vertex AI 的 Nano Banana 2 429 錯誤對比
很多開發者在選擇 AI Studio 和 Vertex AI 時感到困惑。兩個平臺使用相同的模型,但限流策略和穩定性存在顯著差異。

| 對比項 | Google AI Studio | Vertex AI |
|---|---|---|
| RPM 限制 | 標準 Tier 限額 | 更高自定義額度(需申請) |
| RPD 限制 | 嚴格執行 | 可通過配額申請提高 |
| 429 頻率 | 較高 | 中等 |
| 穩定性 | 波動較大 | 相對穩定但仍有問題 |
| 額度提升 | 僅通過消費升 Tier | 可提交配額提升申請 |
| 計費方式 | 按 Token 計費 | 按 Token 計費 |
| 適合場景 | 個人開發/測試 | 企業級生產 |
AI Studio 和 Vertex AI 共同面臨的 429 錯誤困境
無論選擇哪個平臺,Google 的 Nano Banana 2 限流設計都有以下核心痛點:
- Tier 1 限額過低:每天僅 1,000 次請求(RPD),每分鐘僅 10 張圖(IPM),對批量出圖場景完全不夠
- Tier 升級門檻高:需要 30 天內消費達 $250 才能升到 Tier 2,且升級不是即時生效
- 限額是項目級別的:同一 Google Cloud 項目下所有 API Key 共享限額,多 Key 輪詢無效
- Vertex AI 也不穩定:多位開發者在 Google 開發者論壇反饋,即使在 Vertex AI 上也頻繁遇到 RESOURCE_EXHAUSTED 錯誤
🔍 開發者社區反饋:在 Google AI Developers Forum 上,有開發者報告即使將
GOOGLE_GENAI_USE_VERTEXAI設爲False(切回 Gemini API),相同負載下的 RESOURCE_EXHAUSTED 錯誤反而減少了。這說明 Vertex AI 的限流策略可能更爲嚴格。
5 種解決 Nano Banana 2 429 錯誤的方案
方案一:指數退避重試(治標不治本)
遇到 429 錯誤時,最基礎的應對是實現指數退避重試。RPM 限制在 60 秒後重置,等待後重試即可恢復。
import time
import requests
def generate_with_retry(payload, max_retries=5):
"""帶指數退避的 Nano Banana 2 調用"""
for attempt in range(max_retries):
response = requests.post(ENDPOINT, headers=headers, json=payload)
if response.status_code == 429:
wait = min(2 ** attempt, 60)
print(f"429 限流,等待 {wait} 秒後重試...")
time.sleep(wait)
continue
return response.json()
raise Exception("重試次數耗盡,仍然被限流")
查看完整實現代碼(含 RPD 檢測和自動切換)
import time
import requests
from datetime import datetime, timezone, timedelta
API_KEY = "your-api-key"
ENDPOINT = "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent"
headers = {
"Content-Type": "application/json",
"x-goog-api-key": API_KEY
}
daily_count = 0
daily_limit = 1000 # Tier 1 RPD
def check_daily_reset():
"""檢查是否已過太平洋時間午夜"""
global daily_count
pst = timezone(timedelta(hours=-8))
now = datetime.now(pst)
if now.hour == 0 and now.minute < 5:
daily_count = 0
print("RPD 計數已重置")
def generate_image(prompt, aspect_ratio="1:1", image_size="1K", max_retries=5):
global daily_count
check_daily_reset()
if daily_count >= daily_limit:
print(f"已達 RPD 上限 ({daily_limit}),請等待午夜重置")
return None
payload = {
"contents": [{"parts": [{"text": prompt}]}],
"generationConfig": {
"responseModalities": ["IMAGE"],
"imageConfig": {
"aspectRatio": aspect_ratio,
"imageSize": image_size
}
}
}
for attempt in range(max_retries):
response = requests.post(
ENDPOINT, headers=headers,
json=payload, timeout=120
)
if response.status_code == 200:
daily_count += 1
return response.json()
elif response.status_code == 429:
wait = min(2 ** attempt, 60)
print(f"429 限流 (嘗試 {attempt+1}/{max_retries}),等待 {wait}s...")
time.sleep(wait)
else:
print(f"錯誤 {response.status_code}: {response.text}")
return None
print("重試耗盡,建議切換到不限併發的平臺")
return None
侷限:指數退避只能緩解 RPM 限制。如果觸發的是 RPD(每日上限)或 IPM 限制,等待 60 秒沒有意義——你需要等到太平洋時間午夜才能重置。
方案二:升級 Tier 層級
通過增加 Google Cloud 消費來升級 Tier,獲得更高限額。
| 升級路徑 | 條件 | RPD 提升 | IPM 提升 | 月消費估算 |
|---|---|---|---|---|
| Free → Tier 1 | 啓用計費 | 50 → 1,000 | 2 → 10 | $0+ |
| Tier 1 → Tier 2 | 30天消費 ≥$250 | 1,000 → 5,000 | 10 → 30 | ~$250 |
| Tier 2 → Tier 3 | 30天消費 ≥$1,000 | 5,000 → 10,000 | 30 → 60 | ~$1,000 |
現實問題:即使升到 Tier 3,每天也只有 10,000 次請求,每分鐘 60 張圖。對於需要批量生成的場景(電商產品圖、多語言海報等),這個限額仍然不夠。
方案三:多項目輪詢(效果有限)
創建多個 Google Cloud 項目,每個項目獨立限額,通過輪詢分擔請求壓力。
注意:Google 的 Terms of Service 對此有限制。創建過多項目可能觸發審查,且管理成本較高。不推薦作爲長期方案。
方案四:使用 Batch API 降低成本
Google 提供的 Batch API 雖然不能直接提高限額,但可以將每張圖成本降低 50%。適合不需要實時生成的批量任務。
- 標準 API:輸出圖像 $60/M Tokens → Batch API:$30/M Tokens
- 適合場景:定期批量生產素材、離線圖像處理
方案五:使用不限併發的第三方平臺(推薦)
如果你的業務需要穩定、高頻地調用 Nano Banana 2,繞過 Google 限流體系是最徹底的解決方案。
🎯 最終選擇:受制於 AI Studio 和 Vertex AI 的 RPD 和 RPM 限制問題,我們最終選擇了 API易 apiyi.com 平臺。核心優勢:
- 不限併發:沒有 RPM/RPD/IPM 限制,不會遇到 429 錯誤
- 價格低至 $0.045/張:按次計費包含 4K 分辨率,不區分分辨率
- 按量計費更便宜:按 Token 計費約 $0.02-$0.05/張
- 支持谷歌原生格式調用:API 格式與 Google 官方一致,遷移成本極低
Nano Banana 2 通過 API易 調用實戰
極簡示例
切換到 API易 只需要修改 API 端點和 Key,代碼幾乎不用改:
import requests
import base64
API_KEY = "your-apiyi-api-key"
ENDPOINT = "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent"
headers = {
"Content-Type": "application/json",
"x-goog-api-key": API_KEY
}
payload = {
"contents": [{"parts": [{"text": "一隻穿宇航服的貓咪,數字藝術風格"}]}],
"generationConfig": {
"responseModalities": ["IMAGE"],
"imageConfig": {
"aspectRatio": "1:1",
"imageSize": "2K"
}
}
}
response = requests.post(ENDPOINT, headers=headers, json=payload, timeout=120)
result = response.json()
image_data = result["candidates"][0]["content"]["parts"][0]["inlineData"]["data"]
with open("output.png", "wb") as f:
f.write(base64.b64decode(image_data))
print("圖片已保存爲 output.png")
建議:通過 API易 apiyi.com 可以直接體驗 Nano Banana 2 出圖效果。平臺還提供了免費的出圖測試工具 AI 圖片大師: imagen.apiyi.com ,無需寫代碼即可測試。

Nano Banana 2 429 錯誤方案對比
| 方案 | 解決程度 | 成本影響 | 實施難度 | 推薦場景 |
|---|---|---|---|---|
| 指數退避 | ⭐⭐ | 無額外成本 | 低 | 低頻調用,偶發 429 |
| 升級 Tier | ⭐⭐⭐ | $250-$1,000/月 | 低 | 中等頻率,可接受升級週期 |
| 多項目輪詢 | ⭐⭐ | 管理成本高 | 中 | 短期過渡(不推薦長期) |
| Batch API | ⭐⭐ | 降低 50% | 中 | 離線批量處理 |
| API易平臺 | ⭐⭐⭐⭐⭐ | 按次 $0.045/張 | 極低 | 批量生產/高頻調用/生產環境 |
Nano Banana 2 不同方案的價格對比
| 分辨率 | Google 官方 | API易 按次 | API易 按量 | API易 節省比例 |
|---|---|---|---|---|
| 512px | $0.045 | $0.045 | 約 $0.018 | 最高 60% |
| 1K | $0.067 | $0.045 | 約 $0.025 | 最高 63% |
| 2K | $0.101 | $0.045 | 約 $0.03 | 最高 70% |
| 4K | $0.151 | $0.045 | 約 $0.045 | 最高 70% |
常見問題
Q1: Nano Banana 2 的 429 錯誤多久能恢復?
取決於觸發的限流維度。RPM(每分鐘請求數)限制在 60 秒後滾動重置;IPM(每分鐘圖像數)同樣 60 秒重置。但如果觸發的是 RPD(每日請求數),則需要等到太平洋時間午夜(北京時間下午 4 點或 3 點夏令時)才能重置。
Q2: 多個 API Key 能繞過 429 限流嗎?
不能。Google 的限流是按 Google Cloud 項目(Project)維度執行的,而不是按 API Key。同一項目下的所有 Key 共享同一個限額池。創建新 Key 不會增加限額。如果需要不限併發的方案,建議使用 API易 apiyi.com 等第三方平臺。
Q3: 從 Google 官方 API 遷移到 API易 需要改多少代碼?
遷移成本極低。API易 支持 Google 原生 API 格式調用,你只需要:
- 將 API 端點從
generativelanguage.googleapis.com改爲api.apiyi.com - 將 API Key 替換爲 API易 的 Key
- 其他代碼(請求格式、參數、響應解析)完全不變
總結
Nano Banana 2 429 錯誤的核心要點:
- 429 錯誤佔比 70%:是 Nano Banana 2 最常見的問題,根因是 Google 的 4 維限流體系(RPM/TPM/RPD/IPM)
- Tier 1 限額極低:每日僅 1,000 次請求,每分鐘僅 10 張圖,批量場景完全不夠
- AI Studio 和 Vertex AI 都受限:兩個平臺都面臨相同的限流設計,Vertex AI 在某些場景甚至更嚴格
- 最徹底方案是繞過限流:使用不限併發的第三方平臺從根本上避免 429 錯誤
推薦通過 API易 apiyi.com 接入 Nano Banana 2,不限併發、價格低至 $0.045/張(含 4K),支持 Google 原生格式調用。平臺還提供免費的 AI 圖片大師出圖工具: imagen.apiyi.com ,可以快速體驗效果。
📚 參考資料
-
Google AI 速率限制文檔: Gemini API 官方限額說明
- 鏈接:
ai.google.dev/gemini-api/docs/rate-limits - 說明: 查看最新的 Tier 限額數據和限流維度定義
- 鏈接:
-
Vertex AI 429 錯誤文檔: Google Cloud 官方錯誤代碼說明
- 鏈接:
docs.cloud.google.com/vertex-ai/generative-ai/docs/provisioned-throughput/error-code-429 - 說明: Vertex AI 環境下 429 錯誤的官方排查指南
- 鏈接:
-
Google AI 開發者論壇: Nano Banana 2 穩定性討論
- 鏈接:
discuss.ai.google.dev - 說明: 開發者社區關於 RESOURCE_EXHAUSTED 錯誤的真實反饋和解決經驗
- 鏈接:
-
API易 Nano Banana 2 文檔: 第三方接入指南
- 鏈接:
docs.apiyi.com/en/api-capabilities/nano-banana-2-image - 說明: 無限流限制的 Nano Banana 2 API 接入方式和價格說明
- 鏈接:
作者: APIYI 技術團隊
技術交流: 歡迎在評論區討論,更多資料可訪問 API易 docs.apiyi.com 文檔中心
