Nano Banana 在 Gemini 里不出图，不一定是同一个故障。它可能是 Gemini 应用会话卡住，Pro 重做入口不在当前账号路线，提示词触发策略边界，API 项目撞到配额，第三方工具改坏了上传或模型映射，也可能只是某条服务路线暂时过载。
先选失败的入口，再做一个可逆修复，并在同一入口复测一次。只要信号指向权限、配额、策略、过载或更大范围状态，就停止盲目重试。
| 失败入口 | 常见现象 | 第一动作 | 复测方式 | 停止或转交规则 |
|---|---|---|---|---|
| Gemini 网页或移动端 | 加载不动、生成卡住、出现“出错了” | 重开标签页或应用，再开一个新对话 | 同一个账号、同一个简化请求，只试一次 | 仍失败就查提示词、账号路线或状态，不继续连点生成 |
| Pro 重做路线 | “Redo with Pro” 不显示、不可用或前后不一致 | 确认账号、订阅入口、区域和第一张图的生成路线 | 从确认可用的 Pro 路线重新做一次同类任务 | 账号和路线未确认前，不按全站故障处理 |
| 提示词或策略 | Gemini 回文字、不返回图片、拒绝或只解释 | 把提示词缩成一个明确的图片请求 | 用短提示词只要求一张图 | 如果仍像策略边界，改写提示词，不重复轰炸 |
| AI Studio 或 Gemini API | 403、429、503、无 image part、请求失败 | 查模型 ID、key/项目、计费、配额、payload 和状态 | 只重试一次修正后的同一路径请求 | 429 和 503 走各自分支，不用清应用缓存解决 API 错误 |
| 封装工具或第三方入口 | Figma、Make、SDK、网关或上传流程失败 | 同提示词直接跑 Gemini 应用或 API，并对照日志 | 修一个封装层变量后复测 | 保存路线、时间、提示词、模型、错误码、request id、截图和日志 |
| 状态或故障怀疑 | 多个入口同时失败、持续 503、状态页出现信号 | 查官方状态归属，并做一个直接入口对照 | 等待或切换路线前先确认状态 | 论坛只是症状发现，不能当作实时故障证明 |
截至 2026-06-28，同轮核验的 Google 图片生成文档把 Nano Banana 2 对应到 gemini-3.1-flash-image，Nano Banana Pro 对应到 gemini-3-pro-image，较早 Nano Banana 路线对应到 gemini-2.5-flash-image。状态、额度、价格、订阅权益、区域可用性和供应商承诺都属于波动事实，发布时只能按最新核验来写。
12 个修复动作要按路线选
不要把 12 个动作从头跑到尾。先用症状确定路线，再做一个动作，最后在同一路线复测一次。这样可以避免把配额、权限或策略问题搅成一个没有复现价值的重试现场。
| # | 路线 | 修复动作 | 适用场景 | 验证方式 |
|---|---|---|---|---|
| 1 | 应用会话 | 重启标签页或应用 | Gemini 页面卡住、移动端转圈、第一次生成未完成 | 同一对话、同一简化提示词，试一次 |
| 2 | 应用会话 | 开新对话 | 当前聊天有多轮编辑、上传、失败记录 | 新对话里只放必要提示词 |
| 3 | 应用或移动端 | 更新浏览器或应用 | 桌面能用、移动端异常，或入口看起来滞后 | 更新后同账号同请求复测 |
| 4 | 提示词/策略 | 缩短提示词 | 只回文字、拒绝、没有图片 | 一句话明确要求“生成一张图片” |
| 5 | Pro 路线 | 核对 Pro 入口 | Pro 重做缺失、不可点击、入口不一致 | 先确认账号和路线，再重做 |
| 6 | API | 核对模型 ID | 请求还没生成就失败 | 使用当前官方图片模型 ID |
| 7 | API | 核对 key 和项目 | 401、403、项目权限字样 | 用确认过的 key/project 复测 |
| 8 | API | 查计费和配额 | 出现 429 或 RESOURCE_EXHAUSTED | 查项目级限制归属 |
| 9 | API | 停止 429 循环 | 多次重试仍是 429 | 退避，修 quota/rate/spend 分支 |
| 10 | API/状态 | 查 503 状态 | 出现 UNAVAILABLE、过载或多路线失败 | 查官方状态和重试策略 |
| 11 | 封装工具 | 查 payload 映射 | 第三方工具失败，直接 Gemini 可能成功 | 对照直接入口和封装入口 |
| 12 | 升级处理 | 保存证据包 | 一次控制变量复测后仍失败 | 保存时间、路线、模型、提示词、错误码、request id、截图、日志 |
Gemini 应用和移动端先修会话
如果失败发生在 Gemini 网页或移动端，第一轮不要去改 API key、账单或模型 ID。应用入口的问题通常来自卡住的对话状态、旧的 UI 路线、浏览器或 App 缓存、网络切换、上传文件上下文，或者 Gemini 把提示词理解成文字回答任务。
最小动作是这些：
- 重新加载浏览器标签页，或完全关闭再打开移动端应用。
- 当前聊天包含多次编辑、上传或失败记录时，开一个干净的新对话。
- 移动端和桌面端表现不一致时，先更新 Gemini 或 Google App。
- 把提示词缩成一个主体、一个风格、一个输出目标。
- 上传文件参与生成时，先做一个不带文件的基线测试，再做一个只带必要文件的直接编辑。
同一路线复测很关键。你不能同时换设备、换账号、重写提示词、清缓存、换网络，然后宣布其中一个动作修好了问题。一次只改一个变量，才知道真正 owner 在哪里。
如果加载循环变成拒绝，问题已经从应用会话移动到提示词或策略。如果移动端失败但桌面成功，优先查 App 版本、账号入口和区域入口，而不是把它写成 Google API 故障。
Pro 重做入口要按账号和路线排查
“Nano Banana Pro 不能用”经常不是模型质量问题，而是入口和账号问题。Pro 动作可能受当前 Google 账号、订阅界面、区域、灰度状态，以及第一张图是从哪个入口生成的影响。用户看到的按钮缺失，不等于模型不可用。
| 要确认的问题 | 为什么重要 | 下一步 |
|---|---|---|
| 当前是否是预期 Google 账号 | 多账号登录会让 Gemini 显示不同订阅和功能路线 | 切到拥有预期权益的账号后刷新 |
| 第一张图是否来自支持重做的入口 | 有些 Pro 动作依赖初始图片的生成路线 | 在目标入口生成一张干净基线图，再看重做 |
| 当前界面今天是否提供该功能 | Gemini 应用、AI Studio、API、第三方工具是不同合同 | 查当前帮助或状态归属，不凭旧截图判断 |
| 是否有区域或计划限制 | 可用性和权益会变化 | 只保留当前核验过的可用性描述 |
不要用 API payload 去修一个消费级 Pro 按钮问题。只有失败入口是 AI Studio 或 Gemini API 时，下面的 API 分支才是正确入口。
提示词和策略问题不要硬重试
Gemini 回文字、不出图、拒绝或只给解释时，最快测试不是写更长的提示词，而是把意图缩小。你要证明模型看到了一个允许生成的、明确的图片任务。
可以用这种结构：
text生成一张图片：[主体]。 风格：[视觉风格]。 除非我明确要求，否则不要在图里加文字。 只返回图片。
然后减少模糊变量：
- 把复杂多场景拆成一个主体和一个背景。
- 删除不必要的品牌、名人、版权角色或私人身份描述。
- 不要在基线图还失败时要求“修复上一张失败图片”。
- 不要一次要求多个比例、多个文件格式、多个编辑目标。
- 有上传图时，分别测试“不带上传图的文生图”和“只带必要上传图的编辑”。
策略形状的失败应该改写，而不是重复同一请求。重复同一提示词不会让策略 owner 变成容量 owner，只会浪费额度并污染后续判断。
还有一个常见误区：把“文字解释很完整”当成模型已经理解图片任务。对 Gemini 来说，文字回答和图片输出是两个不同的结果形态。只要没有真实 image part，排查就还没有结束；你需要缩小任务、明确图片输出，并记录这一次响应到底是拒绝、解释、无图像还是结构化 API 分支。
AI Studio 和 Gemini API 要看请求合同
开发者入口需要完全不同的检查清单。清 Gemini 应用缓存不会修好错误模型 ID、项目权限、计费路径、配额、payload 结构、文件资源或 503。
先核对当前模型映射：
| 市场可见名称 | 当前官方 API 模型 ID |
|---|---|
| Nano Banana 2 | gemini-3.1-flash-image |
| Nano Banana Pro | gemini-3-pro-image |
| 较早 Nano Banana 路线 | gemini-2.5-flash-image |
如果代码还在使用旧教程里的 -preview 字符串，先对照 Google AI for Developers 的图片生成文档，再看其它错误。一个过时模型 ID 很容易被误判成更大的服务故障。
API 错误先按类别读：
| 错误或现象 | 要验证的含义 | 第一修复 | 停止规则 |
|---|---|---|---|
| 401 或 403 | key、项目、权限、API 启用或路线访问 | 确认 key、项目、账号、区域和 API enablement | 权限未修好前不要重试 |
429 RESOURCE_EXHAUSTED | rate、quota、spend 或项目限制 | 查项目级限制和当前模型限制 | 退避；重复重试可能继续消耗预算或掩盖桶位 |
503 UNAVAILABLE | 临时过载或不可用 | 查状态和重试策略，降低请求压力 | 不要按提示词问题处理 |
| HTTP 成功但无图像 | 请求形态、输出模态或 parser | 明确图片输出，并遍历 response parts | 不要马上宣布模型宕机 |
| 封装层说 model failed | 供应商或传输层可能拥有故障 | 同提示词直接跑 Gemini 应用或 API | 直接入口对照后再找供应商 |
Google 的 Gemini API troubleshooting 文档把 429 放在限制分支，把 503 放在过载或不可用分支。rate-limit 文档还说明限制按项目归属，不能只按单个 API key 理解。因此，同项目轮换 key 通常不是第一动作。
更深的 API 分支可以转到 Gemini 图片生成错误、限制和水印参考、Gemini 图片 429 rate limit 或 Gemini 3 Pro Image 503 overloaded。
封装工具、SDK 和供应商入口要做直接对照
第三方工具的错误提示经常只写“model failed”，但真实 owner 可能是上传映射、文件大小、MIME type、模型别名、SDK 版本、webhook timeout、租户限制或网关重试策略。
先做直接路线对照：
- 保存原始提示词和输入文件。
- 如果原失败在消费入口，就用 Gemini 应用直接跑；如果原失败在开发者入口，就用 AI Studio 或 Gemini API 直接跑。
- 直接入口成功时，查封装工具的 model alias、payload 字段名、上传 URL、MIME type、文件大小和 timeout。
- 直接入口也失败时，回到提示词、API 或状态分支。
- 改 SDK 或重试逻辑前，先保存供应商日志。
供应商或网关路线只在 API 分支已证明后才有意义。网关会改变计费、日志、支持归属和失败合同，但不会把 Gemini 应用会话问题变成 API 问题，也不能代表 Google 官方价格、额度或状态。
什么时候停止、切换或升级处理
最贵的排错错误是一次改完所有变量。那样既不知道哪个动作有效，也没有可复现证据给 Google、供应商或自己的工程团队。
| 信号 | 停止做什么 | 改做什么 |
|---|---|---|
| 403 或权限字样 | 停止用同一凭据重试 | 修账号、key、项目、权限或路线访问 |
429 或 RESOURCE_EXHAUSTED | 停止盲目 retry loop | 查项目限制、降压，并走 429 分支 |
| 策略形状拒绝 | 停止重复同一提示词 | 改写成允许内容和更清晰图片意图 |
| 503 或过载字样 | 停止先改提示词 | 查官方状态并降低重试压力 |
| 只在封装工具失败 | 停止先改提示词 | 对照直接入口并查 payload/log |
| 多入口同时失败 | 停止把论坛当证明 | 查 AI Studio status 或失败入口的官方归属 |
升级处理要带证据，而不是一句“Nano Banana 坏了”。最低证据包包括：时间和时区、失败入口、可安全共享的账号或项目标识、最小复现提示词、API 模型 ID、错误码、message body、request ID、截图、服务器日志、一次同入口复测结果、一次直接入口对照结果。
更深分支应该交给专门页面
前门排错板的职责是分类，不是替代所有深分支：
- 只判断是否大范围故障时，看 Is Nano Banana 2 Down?。
- 只有 API 429 时，看 Gemini 图片 429 rate limit。
- 持续 503 过载时，看 Fix Gemini 3 Pro Image 503 Overloaded。
- 价格、免费额度、Nano Banana 2 vs Pro 成本问题，看 Nano Banana API Pricing。
- 需要 Pro 工作流语境时，看 Nano Banana Pro how to use。
实用规则很短：先证明分支，再打开对应深分支。
常见问题
为什么 Nano Banana 在 Gemini 里不生成图片？
最常见原因是失败入口没有分清。Gemini 应用会话、Pro 重做路线、提示词策略、API 项目限制、封装 payload 和状态故障都可能表现成“不生成图片”。先选入口，做一个匹配动作，再同入口复测一次。
Nano Banana 今天宕机了吗？
不能从一个论坛帖或一次失败提示词推断。先查你正在使用的官方状态归属，再做一个直接入口对照。429、403、提示词拒绝或封装工具失败，都不等于实时宕机。
Gemini 图片生成里的 429 是什么意思？
429 RESOURCE_EXHAUSTED 属于 rate、quota、spend 或项目限制分支。它不是 Nano Banana 宕机证明。查项目限制归属，降低重试压力，需要时进入 429 专门路线。
Nano Banana 或 Gemini 图片错误里的 503 是什么意思？
503 UNAVAILABLE 表示该路线暂时过载或不可用。先查状态和重试策略，再决定是否等待、排队或切换路线，不要第一步就改提示词或账号。
为什么 API 失败但 Gemini 应用能用？
应用和 API 是不同合同。API 可能因为模型 ID、key/project、计费、配额、payload 或区域失败，而消费级 Gemini 应用仍然正常。按开发者分支排查，不要清应用缓存。
为什么 Gemini 应用失败但 API 能用？
应用路线可能来自会话状态、账号入口、Pro 重做可用性、UI 灰度或提示词解释，而 API 仍健康。先做应用会话和路线检查，再对照直接入口。
Nano Banana 失败时要不要换供应商？
只有分支证明后再考虑。如果已证明问题是 API 路由、计费、日志或集成归属，供应商路线可能有帮助。它不能修 Gemini 应用会话、被策略拦住的提示词或 Pro 权益路线。
联系支持前要保存什么？
保存时间、路线、提示词、模型、错误码、request ID、截图或日志、一次同入口复测结果和一次直接入口对照结果。这比一句“无法生成图片”更能帮助定位 owner。