# Nano Banana 无法生成图片？Gemini 图片错误的 12 个修复分支 > 把 Nano Banana 无法生成图片先拆成 Gemini 应用、Pro 重做、提示词策略、API 项目、封装工具、配额和状态分支，再选择一次可验证的修复动作。 - URL: https://blog.laozhang.ai/zh/posts/nano-banana-not-working-gemini-image-errors - Published: 2026-06-28 - Updated: 2026-06-28 - Author: AI Free API Team (https://blog.laozhang.ai/zh/about) - Category: Gemini 图片 - Tags: Nano Banana, Gemini 图片, Gemini API, 图片生成排错, 429, 503 --- 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 个动作从头跑到尾。先用症状确定路线，再做一个动作，最后在同一路线复测一次。这样可以避免把配额、权限或策略问题搅成一个没有复现价值的重试现场。 ![Nano Banana 图片错误的 12 个路线检查](https://blog.laozhang.ai/posts/zh/nano-banana-not-working-gemini-image-errors/img/route-checks.webp) | # | 路线 | 修复动作 | 适用场景 | 验证方式 | |---|---|---|---|---| | 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。 ![Gemini API 图片错误矩阵](https://blog.laozhang.ai/posts/zh/nano-banana-not-working-gemini-image-errors/img/api-error-matrix.webp) 先核对当前模型映射： | 市场可见名称 | 当前官方 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 图片生成错误、限制和水印参考](https://blog.laozhang.ai/zh/posts/gemini-image-generation-error-limit-watermark)、[Gemini 图片 429 rate limit](https://blog.laozhang.ai/zh/posts/gemini-image-429-rate-limit) 或 [Gemini 3 Pro Image 503 overloaded](https://blog.laozhang.ai/zh/posts/fix-gemini-3-pro-image-503-overloaded)。 ## 封装工具、SDK 和供应商入口要做直接对照 第三方工具的错误提示经常只写“model failed”，但真实 owner 可能是上传映射、文件大小、MIME type、模型别名、SDK 版本、webhook timeout、租户限制或网关重试策略。 先做直接路线对照： 1. 保存原始提示词和输入文件。 2. 如果原失败在消费入口，就用 Gemini 应用直接跑；如果原失败在开发者入口，就用 AI Studio 或 Gemini API 直接跑。 3. 直接入口成功时，查封装工具的 model alias、payload 字段名、上传 URL、MIME type、文件大小和 timeout。 4. 直接入口也失败时，回到提示词、API 或状态分支。 5. 改 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?](https://blog.laozhang.ai/zh/posts/is-nano-banana-2-down)。 - 只有 API 429 时，看 [Gemini 图片 429 rate limit](https://blog.laozhang.ai/zh/posts/gemini-image-429-rate-limit)。 - 持续 503 过载时，看 [Fix Gemini 3 Pro Image 503 Overloaded](https://blog.laozhang.ai/zh/posts/fix-gemini-3-pro-image-503-overloaded)。 - 价格、免费额度、Nano Banana 2 vs Pro 成本问题，看 [Nano Banana API Pricing](https://blog.laozhang.ai/zh/posts/nano-banana-api-pricing-free-vs-pro)。 - 需要 Pro 工作流语境时，看 [Nano Banana Pro how to use](https://blog.laozhang.ai/zh/posts/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。