Cuando Nano Banana no funciona en Gemini, el fallo no siempre pertenece al mismo lugar. El mismo prompt puede quedarse colgado en la app de Gemini, perder la ruta de Pro redo, chocar con una política de contenido, agotar la cuota de un proyecto API, fallar dentro de un wrapper de terceros o encontrar una ruta temporalmente sobrecargada.
Primero identifica la superficie que falló. Después aplica un solo arreglo reversible y repite esa misma superficie una vez. Si aparece una señal de permission, quota, policy, overload o status, deja de hacer retries ciegos y mueve el caso a la rama correcta.
| Superficie fallida | Síntoma visible | Primer paso | Repetición | Cuándo parar o transferir |
|---|---|---|---|---|
| Gemini web o mobile app | Generación atascada, carga infinita, "something went wrong" | Reiniciar pestaña o app y abrir un chat limpio | Mismo account, mismo prompt simplificado, una vez | Si sigue fallando, revisar prompt, account route o status |
| Ruta Pro redo | Redo with Pro no aparece, no se puede usar o varía | Confirmar account, plan surface, región y ruta de la primera imagen | Crear una imagen base desde la ruta Pro confirmada | No asumir outage antes de confirmar account y route |
| Prompt o policy | Gemini responde texto, rechaza o no entrega imagen | Reducir a una sola tarea de imagen permitida | Ejecutar un prompt corto image-only | Si parece policy, reescribir en vez de insistir |
| AI Studio o Gemini API | 403, 429, 503, no image part, request failed | Revisar model ID, key/project, billing, quota, payload y status | Repetir una solicitud corregida por la misma ruta | 429 y 503 tienen reglas distintas; la cache de la app no ayuda |
| Wrapper, SDK o provider tool | Figma, Make, gateway, upload flow o SDK falla | Comparar el mismo prompt en ruta directa y revisar logs | Corregir una variable del wrapper y repetir | Guardar route, timestamp, prompt, model, code, request id, screenshot y logs |
| Sospecha de status u outage | Varias rutas fallan, 503 persiste, hay status signal | Consultar el owner oficial de status y comparar una ruta directa | Esperar, poner en cola o cambiar solo después de verificar status | Los foros son vocabulario de síntomas, no prueba de outage en vivo |
Según la documentación de Google image generation revisada el 28 de junio de 2026, Nano Banana 2 corresponde a gemini-3.1-flash-image, Nano Banana Pro a gemini-3-pro-image, y la ruta anterior de Nano Banana a gemini-2.5-flash-image. Status, cuotas, precios, beneficios de plan, disponibilidad regional y promesas de proveedores son datos volátiles; no conviene publicarlos como hechos sin verificación actual.
Los 12 arreglos se eligen por ruta, no por orden
No ejecutes los 12 pasos como una lista lineal. El síntoma sirve para elegir ruta. Una vez elegida, cambia una sola variable y repite la misma ruta una vez. Así evitas convertir una cuota, un permiso o una política en un bucle de retries sin señal.
| # | Ruta | Arreglo | Úsalo cuando | Verificación |
|---|---|---|---|---|
| 1 | App session | Reiniciar pestaña o app | Gemini se queda loading, la UI se congela o la primera generación no termina | Mismo chat, mismo prompt, un retry |
| 2 | App session | Abrir chat limpio | El chat tiene muchas ediciones, uploads o fallos | Nuevo chat, misma solicitud simplificada |
| 3 | App/mobile | Actualizar app o browser | Mobile y desktop se comportan distinto | Misma solicitud después de update |
| 4 | Prompt/policy | Simplificar prompt | Text-only response, refusal o no image | Prompt corto image-only |
| 5 | Pro route | Revisar ruta Pro | Redo with Pro missing o inconsistent | Confirmar account y route antes de retry |
| 6 | API | Revisar model ID | La request falla antes de generar | Usar el current official image model ID |
| 7 | API | Revisar key y project | 401, 403 o permission wording | Misma request con key/project verificados |
| 8 | API | Revisar billing y quota | 429 o RESOURCE_EXHAUSTED | Inspeccionar project limit owner |
| 9 | API | Detener loop 429 | Los retries siguen devolviendo 429 | Backoff y corrección de quota/rate/spend |
| 10 | API/status | Revisar 503 status | UNAVAILABLE, overload o fallo amplio | Official status y retry policy |
| 11 | Wrapper | Revisar payload mapping | La herramienta externa falla y la ruta directa puede funcionar | Comparar direct route con wrapper route |
| 12 | Escalation | Guardar evidence pack | Un retest controlado sigue fallando | Timestamp, route, model, prompt, code, request id, screenshot, logs |
En la app de Gemini y móvil, empieza por la sesión
Si el fallo ocurre en la app de Gemini, no empieces por API keys, billing ni model IDs. Los fallos de app suelen venir de conversation state atascado, UI route antigua, cache de browser o app, cambio de red, contexto de archivos subidos o una interpretación del prompt como tarea de texto.
Acciones mínimas:
- Recarga la pestaña del browser o cierra por completo la app móvil y vuelve a abrirla.
- Abre un chat limpio si la conversación tiene muchas ediciones, uploads o intentos fallidos.
- Actualiza Gemini o Google app si mobile y desktop se comportan distinto.
- Reduce el prompt a un subject, un style y una expectativa de salida.
- Si hay imagen subida, prueba primero una base sin archivo y después una edición directa con solo el archivo necesario.
La repetición por la misma superficie importa porque conserva la causa. Si cambias device, account, network, prompt y cache al mismo tiempo, no sabrás qué arregló o rompió la ruta. Una variable modificada por prueba es suficiente.
Si una carga infinita se convierte en refusal, el caso ya no es app session; se movió a prompt o policy. Si mobile falla y desktop funciona, revisa app version, account route y region route antes de llamarlo caída de Gemini API.
Pro redo debe separarse de account y route
"Nano Banana Pro no funciona" suele ser un problema de access route, no de calidad del modelo. La ruta visible depende de Google account, subscription surface, región, rollout y de la ruta en la que se generó la primera imagen.
| Pregunta | Por qué importa | Siguiente acción |
|---|---|---|
| ¿Es el Google account correcto? | Varias cuentas pueden mostrar planes y features distintas | Cambia al account con acceso esperado y recarga Gemini |
| ¿La primera imagen salió de la ruta compatible? | Algunas acciones Pro dependen del initial image path | Crea una primera imagen limpia en la ruta objetivo y revisa redo |
| ¿La función existe hoy en esa surface? | Gemini app, AI Studio, API y wrapper son contratos separados | Verifica el help/status owner de esa surface |
| ¿Depende de región o plan? | La disponibilidad cambia | Usa solo wording verificado en la corrida actual |
No intentes arreglar un botón Pro de la app editando API payload. La rama API de abajo corresponde a AI Studio o Gemini API, no a un control de la app de consumo.
Prompt y policy se corrigen reduciendo ambigüedad
Cuando Gemini devuelve texto, no entrega imagen o rechaza sin un código API limpio, la prueba más rápida es de intent. Un prompt más largo casi nunca es la primera respuesta. Necesitas una tarea corta que pida una imagen con claridad.
textCreate one image: [subject]. Style: [visual style]. Do not include text unless I explicitly ask for it. Return the image only.
Después elimina variables ambiguas:
- Cambia una escena de varios pasos por un subject y un background.
- Quita brand, celebrity, copyrighted character o private-person reference si no son esenciales.
- No pidas "fix the previous failed output" hasta tener una clean base generation.
- No mezcles muchos aspect ratios, file formats y edits en una sola request.
- Con imagen subida, separa una prueba sin upload y una edición directa con el archivo necesario.
Un fallo con forma de policy se reescribe. Repetir el mismo prompt no convierte un content boundary en un capacity problem.
AI Studio y Gemini API se revisan como contrato de request
En rutas de desarrollador, limpiar la cache de la app de Gemini no arregla model ID viejo, project permission ausente, billing inactivo, quota agotada, payload mal formado, file resource o 503 temporal.
Primero confirma los model IDs actuales:
| Market-visible name | Official API model ID |
|---|---|
| Nano Banana 2 | gemini-3.1-flash-image |
| Nano Banana Pro | gemini-3-pro-image |
| Earlier Nano Banana lane | gemini-2.5-flash-image |
Si el código sigue usando strings antiguos con -preview, contrástalos con la documentación actual de Google AI for Developers image generation antes de depurar otras ramas. Un model string viejo puede parecer un fallo amplio cuando solo es mismatch de contrato.
| Error o síntoma | Qué probar | Primer arreglo | Regla de parada |
|---|---|---|---|
| 401 o 403 | Key, project, permission, route access | Confirmar key, project, API enablement, account y region | No repetir hasta corregir access |
429 RESOURCE_EXHAUSTED | Rate, quota, spend, project limit | Revisar project limit owner en AI Studio o quota surface | Backoff; los retries pueden ocultar el bucket real |
503 UNAVAILABLE | Temporary overload o downtime | Revisar status y retry policy; reducir presión | No tratarlo como prompt problem |
| Text response sin image part | Request shape, output modality, parser | Hacer explícito image intent y recorrer response parts | No asumir outage |
| Wrapper says "model failed" | Provider o transport layer | Ejecutar el mismo prompt directo en app/API | Escalar solo tras direct-route comparison |
La documentación de troubleshooting de Google ubica 429 en la rama de limits y 503 en overload/downtime. Los rate-limit docs también explican que los límites son por proyecto, por lo que rotar keys dentro del mismo proyecto normalmente no es el primer movimiento.
Para ramas más profundas, usa Gemini image generation error, limit, and watermark reference, Gemini image 429 rate-limit branch o Gemini 3 Pro Image 503 overloaded branch.
Wrappers, SDK y providers requieren comparación directa
Los fallos de wrapper son fáciles de leer mal. La pantalla puede decir "model failed", pero el owner real puede ser upload mapping, límite de file size, provider tenant limit, SDK version, webhook timeout, model alias o retry policy interna.
Haz esta comparación directa:
- Guarda el prompt exacto y el input file.
- Si el fallo es consumer-facing, repite en Gemini app; si es developer-facing, repite en AI Studio/API.
- Si la ruta directa funciona, inspecciona model alias, payload fields, upload URL, MIME type, file size y timeout del wrapper.
- Si la ruta directa falla igual, vuelve a prompt, API o status branch.
- Guarda provider logs antes de cambiar SDK versions o retry logic.
Una ruta gateway o provider puede ser útil solo después de probar una API branch. Cambia billing, routing, logs y support ownership. No arregla una app session de Gemini, un prompt bloqueado ni una entitlement route de Pro.
Cuándo parar, cambiar o escalar
El error más costoso es cambiar todas las variables a la vez. Pierdes la señal y conviertes el fallo en algo que support no puede reproducir.
| Señal | Deja de hacer esto | Haz esto |
|---|---|---|
| 403 o permission wording | Reintentar con las mismas credenciales | Corregir account, key, project, permission o route access |
429 o RESOURCE_EXHAUSTED | Blind retry loop | Revisar project limits, bajar presión y seguir la rama 429 |
| Refusal con forma de policy | Repetir el mismo prompt | Reescribir con contenido permitido y clearer image intent |
| 503 u overload wording | Corregir prompt como primer paso | Revisar official status y reducir retry pressure |
| Wrapper-only failure | Cambiar prompt primero | Comparar ruta directa y revisar wrapper payload/logs |
| Fallo amplio de rutas | Usar foros como prueba | Revisar AI Studio status u owner oficial de la surface fallida |
La escalación necesita evidencia. Paquete mínimo: timestamp y timezone, failed route, account o project identifier seguro, prompt exacto o minimizado, model ID si hay API, error code, message body, request ID, screenshot, server log, un same-surface retest y una direct-route comparison.
Abre ramas profundas solo después de clasificar
El panel inicial clasifica; no sustituye owners más específicos:
- Para current outage reasoning, usa Is Nano Banana 2 Down?.
- Para API 429, usa Gemini image 429 rate-limit guide.
- Para persistent 503 overload, usa Fix Gemini 3 Pro Image 503 Overloaded.
- Para price, free access o Nano Banana 2 vs Pro cost, usa Nano Banana API Pricing.
- Para contexto de Pro workflow, usa Nano Banana Pro how to use.
Regla práctica: demuestra la branch primero y abre el deep branch owner solo cuando esa branch está probada.
Preguntas frecuentes
¿Por qué Nano Banana no genera imágenes en Gemini?
La razón más común es que todavía no identificaste la ruta fallida. App session, Pro redo route, prompt policy, API project limit, wrapper payload y status problem pueden verse como "no genera imágenes". Elige failed surface, aplica un matching fix y repite una vez.
¿Nano Banana está caído hoy?
No lo deduzcas de un foro ni de un prompt fallido. Revisa el official status owner de la surface que usas y compara una direct route. 429, 403, prompt refusal o wrapper-only failure no significan live outage.
¿Qué significa 429 en Gemini image generation?
429 RESOURCE_EXHAUSTED pertenece a rate, quota, spend o project-limit branch. No prueba que Nano Banana esté caído. Revisa project limit owner, reduce retry pressure y usa la rama 429 si persiste.
¿Qué significa 503 en Nano Banana o Gemini image errors?
503 UNAVAILABLE indica que esa ruta está temporalmente overloaded o unavailable. Revisa status y retry policy antes de cambiar prompts o account settings. Si persiste, pasa a la rama 503 overload.
¿Por qué falla la API si Gemini app funciona?
App y API son contratos separados. La API puede fallar por model ID, key/project, billing, quota, payload o region mientras la app de consumo funciona. Diagnostica developer branch en vez de limpiar cache de app.
¿Por qué falla Gemini app si la API funciona?
La app route puede fallar por session state, account route, Pro redo availability, UI rollout o prompt interpretation mientras la API sigue healthy. Empieza con app-session y route checks.
¿Debo cambiar de provider si Nano Banana falla?
Solo después de branch diagnosis. Un provider route puede ayudar si el problema probado es API routing, billing, logs o integration ownership. No corrige Gemini app session, prompt bloqueado ni Pro entitlement route.
¿Qué guardo antes de contactar support?
Guarda timestamp, route, prompt, model, error code, request ID, screenshot o logs, one same-surface retest result y one direct-route comparison. Eso ayuda más que reportar que la herramienta no funciona.