Si Nano Banana Pro muestra un error al procesar una imagen, no des por hecho que el archivo está corrupto ni que lo ha bloqueado un filtro. Esa frase puede aparecer durante la selección del archivo, la subida, el análisis, la validación de la petición, la generación o incluso cuando la respuesta termina sin una imagen utilizable. Cada etapa exige una comprobación distinta.
La forma más rápida de avanzar es conservar el mensaje exacto, identificar dónde estás usando Nano Banana y hacer una sola comparación controlada en la misma ruta. Si una copia recién exportada funciona y el original no, la imagen es la pista principal. Si ambas fallan, pero una imagen pequeña y conocida funciona, hay que revisar tamaño, número de referencias o complejidad. Si ni siquiera funciona el control, la cuenta, el servicio, la API o el proveedor intermedio pasan a ser candidatos más sólidos.
Respuesta corta: vuelve a subir el archivo una vez si Gemini dice que no pudo analizarlo; si falla de nuevo, deja de repetir y sigue el árbol de diagnóstico. No borres actividad, cambies de plan, rotes claves ni saltes a otro proveedor sin una señal que justifique esa acción.
Antes de tocar la imagen: identifica la ruta y el momento del fallo
«Nano Banana» no designa una única pantalla. En julio de 2026, la ayuda de Gemini Apps distingue Nano Banana 2 para crear y editar imágenes y la opción Rehacer con Pro para suscriptores que regeneran una imagen con Nano Banana Pro. La API, en cambio, usa identificadores de modelo y devuelve campos técnicos. Flow, Vertex AI y las herramientas de terceros añaden contratos propios.
Anota estas dos cosas:
- Superficie: Gemini web o móvil, AI Studio, Gemini API, Vertex AI, Flow o una herramienta de terceros.
- Etapa: selección/lectura, subida, análisis de entrada, validación de petición, generación/edición, respuesta o guardado/visualización.
| Lo que observas | Propietario probable de la siguiente comprobación | Evidencia que debes conservar |
|---|---|---|
| El selector no acepta el archivo | Navegador, aplicación o tipo real del archivo | Formato detectado, tamaño, dimensiones y mensaje exacto |
| La subida termina, pero Gemini no puede analizarlo | Entrada, decodificación o acceso de la cuenta | Mensaje exacto y resultado de una única nueva subida |
| La petición se rechaza antes de generar | Cuenta, límite, política o validación | Aviso de cuenta/plan/límite o código HTTP real |
| La petición termina sin imagen | Respuesta del modelo o integración | finishReason, partes de la respuesta y modelo/endpoint |
| Gemini Apps funciona, pero una web de terceros no | Integración, cola, créditos o subida de esa web | ID seguro del trabajo, estado y respuesta de su soporte |
| La imagen se genera, pero no aparece o no se guarda | Interfaz o almacenamiento de salida | Respuesta recibida, consola/log seguro y paso de visualización |
La frase genérica importa menos que la señal más específica disponible. Un 429, un aviso de almacenamiento o NO_IMAGE vale más que una teoría sobre la caché.
Árbol de diagnóstico: una prueba, una decisión
1. ¿El error aparece al elegir o subir el archivo?
Comprueba en tu dispositivo el tipo real del archivo, no solo la extensión. Una foto llamada imagen.jpg puede contener bytes de otro formato o estar incompleta. Registra:
- tipo MIME o formato detectado;
- tamaño en bytes o MB;
- anchura y altura;
- orientación y, si tu herramienta lo muestra, perfil de color;
- número de imágenes de referencia añadidas.
Si la aplicación dice que no ha podido analizar el archivo, la ayuda oficial de Gemini Apps sobre subidas recomienda volver a subirlo. Hazlo una vez. Si vuelve a fallar, exporta una copia nueva a PNG o JPEG desde una aplicación de confianza, sin modificar ni sobrescribir el original, y pruébala en la misma conversación o ruta.
Interpretación prudente:
- La copia funciona y el original no: el archivo original es el candidato principal; no demuestra qué byte o metadato estaba mal.
- Ambos fallan antes de enviar: revisa compatibilidad, permisos de la cuenta o el propio control de subida.
- Ambos se suben y el error aparece después: deja de tratarlo como un simple problema de formato.
2. ¿La interfaz muestra un aviso de cuenta, edad, organización o límite?
Sigue el aviso literal. La página española para generar y editar imágenes en Gemini Apps indica que hay que iniciar sesión, que la disponibilidad depende del país y del idioma admitidos y que la generación o edición puede estar restringida por edad. Las cuentas de trabajo o de centro educativo también pueden depender de su licencia y de los controles del administrador.
Los límites generales de subida de Gemini Apps tampoco son una promesa de que una edición vaya a completarse. La ayuda permite, sujeto a disponibilidad, hasta 10 archivos admitidos en una petición y establece límites generales para los archivos; además, existen límites variables de uso, almacenamiento y contexto. Por eso:
- un archivo por debajo del máximo general aún puede fallar en una edición concreta;
- pagar un plan no elimina restricciones de edad, país, idioma o Workspace;
- solo borres actividad para liberar espacio cuando la interfaz muestre explícitamente un problema de almacenamiento y hayas revisado qué se eliminará;
- si el aviso dice que se alcanzó un límite temporal, espera al restablecimiento indicado en vez de consumir intentos repetidos.
3. ¿No hay señal explícita? Haz un control mínimo en la misma ruta
Usa una imagen sencilla y no sensible que sepas que abre correctamente: por ejemplo, un PNG o JPEG pequeño exportado por ti. Mantén la misma cuenta, superficie y acción. No cambies a la vez el navegador, el modelo, el proveedor y el prompt, porque perderías la capacidad de atribuir el resultado.
| Resultado de la comparación | Qué sugiere | Qué no demuestra |
|---|---|---|
| El control funciona y el original falla | Entrada original, tamaño, referencias o complejidad | Que exista corrupción concreta o bloqueo de política |
| Original y copia exportada fallan; control funciona | Contenido, dimensiones, contexto o interacción entre referencias | Una causa única sin más señal |
| Ninguna imagen funciona en esa ruta | Cuenta, servicio, integración o elegibilidad | Que Nano Banana esté caído para todo el mundo |
| Gemini Apps funciona y la API o wrapper falla | Petición, proyecto, cola o adaptación de esa ruta | Que la API o el tercero estén sanos |
Detente tras obtener una diferencia útil. Más reintentos idénticos pueden gastar cuota y no añaden evidencia.
Si usas Gemini Apps: qué comprobar sin convertirlo en una lista al azar
La interfaz española actual utiliza términos como Crear imagen, Enviar, Editar imágenes con Nano Banana 2 y Rehacer con Pro. La etiqueta que ves importa: no conviene convertir automáticamente «Pro» en un ID de modelo de API.
Sigue este orden:
- Confirma que estás en la función correcta. Subir una imagen para preguntar sobre ella, editarla y rehacer una salida con Pro no son exactamente la misma operación.
- Guarda el texto completo del aviso. Incluye cualquier mención a límite diario, almacenamiento, edad, país, cuenta de trabajo o centro educativo.
- Vuelve a subir una vez si el mensaje habla de análisis incorrecto del archivo.
- Prueba una copia recién exportada si el mismo archivo vuelve a fallar.
- Comprueba el estado oficial solo si el fallo es general. El 20 de julio de 2026, la página oficial de estado de Google AI Studio y Gemini API mostraba «All Systems Operational». Esa observación está fechada, puede cambiar y no demuestra por sí sola que Gemini Apps, tu cuenta o una herramienta externa funcionen correctamente.
Borrar caché, abrir una ventana privada o iniciar una conversación nueva puede ser una prueba de interfaz, pero no es una solución universal. Úsala únicamente si tienes señales de que la selección, la sesión o la visualización están fallando; no la confundas con una reparación del archivo o del modelo.
Si usas la API: decide por código y por respuesta, no por la frase del wrapper
En una integración, conserva el código HTTP, el cuerpo de respuesta seguro, el modelo y endpoint exactos y el finishReason. No publiques la clave ni el contenido privado de la imagen.
Verifica MIME y transporte
La documentación actual de comprensión de imágenes de la API de Gemini admite estos MIME de imagen: image/png, image/jpeg, image/webp, image/heic e image/heif. Los datos de imagen enviados en línea comparten un límite total de 20 MB con el texto, las instrucciones del sistema y los demás bytes incluidos en la petición. Para entradas mayores o reutilizadas, Google recomienda la API de Files.
Ese límite de 20 MB pertenece a la ruta API en línea. No lo traslades a Gemini Apps ni al formulario de una herramienta externa. También conviene verificar que el Content-Type declarado coincide con los bytes reales.
Usa el estado HTTP para elegir la acción
La guía oficial de solución de problemas de Gemini API separa causas que requieren acciones distintas:
| Señal real | Lectura práctica | Siguiente acción |
|---|---|---|
400 INVALID_ARGUMENT | Petición mal formada o campo no admitido | Corrige esquema, versión, modelo y parámetros; no reintentes igual |
404 NOT_FOUND | Recurso o archivo referenciado no encontrado | Verifica URI, vigencia y parámetros del recurso |
429 RESOURCE_EXHAUSTED | Se agotó algún límite aplicable | Reduce ritmo/tamaño y reintenta con espera; confirma el límite real |
499 CANCELLED | El cliente o la infraestructura canceló | Revisa cierres y timeouts del lado cliente |
500 INTERNAL | Error interno o contexto demasiado grande | Reduce contexto, consulta estado y haz un reintento acotado |
503 UNAVAILABLE | Indisponibilidad o sobrecarga temporal | Espera y usa retroceso exponencial |
504 DEADLINE_EXCEEDED | No terminó dentro del plazo | Reduce trabajo o ajusta un timeout razonable |
Aplica reintentos con espera solo a condiciones que realmente sean transitorias. Un 400 no mejora por repetir la misma carga.
Distingue «sin imagen» de «bloqueado por seguridad»
La referencia de GenerateContent documenta motivos separados: IMAGE_SAFETY, IMAGE_PROHIBITED_CONTENT, IMAGE_OTHER, NO_IMAGE e IMAGE_RECITATION. Si la respuesta contiene NO_IMAGE, no la describas automáticamente como un bloqueo de seguridad. Si aparece un motivo explícito de política, entonces sí debes revisar la petición y el material conforme a las políticas aplicables.
Comprueba también si la respuesta incluye una parte de imagen y si tu código la está leyendo. Una integración puede recibir una respuesta válida y, aun así, no mostrarla por un error de parseo, almacenamiento o renderizado.
Si usas una herramienta de terceros: el wrapper añade otra cadena de fallos
Una web o aplicación externa controla su propio selector de archivos, almacenamiento temporal, cola, créditos, traducción de errores y soporte. Su mensaje «error al procesar la imagen» puede resumir un fallo que nunca llegó a Google o esconder un estado más preciso del trabajo.
Solicita o conserva, si la herramienta lo permite:
- hora exacta y zona horaria;
- estado del trabajo y un ID que sea seguro compartir;
- modelo o ruta que la herramienta afirma haber usado;
- si falló antes o después de descontar créditos;
- código del proveedor aguas arriba, si lo muestra;
- política de conservación y eliminación de la imagen.
No introduzcas una clave API en otra web ni subas una imagen privada solo para «ver si allí funciona» sin revisar antes quién procesa y conserva esos datos. Cambiar de proveedor también cambia privacidad, soporte, cobro y propietario del fallo; no es un paso diagnóstico neutro.
Qué conviene evitar
- Repetir la misma petición muchas veces. Consume límites y no separa causas.
- Reducir toda imagen a “menos de 5 MB”. No existe una regla oficial universal de ese tamaño para este síntoma en todas las superficies.
- Acusar a la imagen de infringir una política por una frase genérica. Exige un aviso o motivo explícito.
- Cambiar varias variables a la vez. Si cambias archivo, cuenta, navegador, modelo y proveedor, un éxito no explica qué se arregló.
- Borrar conversaciones o actividad sin aviso de almacenamiento. Puede ser irreversible y no repara una petición mal formada.
- Rotar claves o activar facturación sin evidencia. Solo corresponde ante una señal de autenticación, permiso, región o facturación del proyecto.
- Compartir la imagen privada o la clave en un ticket. Un soporte legítimo puede trabajar con metadatos, IDs seguros y mensajes de error.
Paquete de evidencia para soporte
Si la comparación no aísla el fallo, prepara un informe breve. Este formato evita idas y vueltas y reduce la exposición de datos:
hljs textFecha y hora (con zona): Superficie: Gemini web/móvil | AI Studio | API | Vertex | Flow | tercero Tipo de cuenta: personal | trabajo/centro educativo (sin correo ni ID) Acción: subir | analizar | editar | generar | rehacer con Pro | guardar Etapa exacta del fallo: Mensaje literal o código HTTP: Archivo: MIME real, tamaño, dimensiones y nº de referencias API, si aplica: modelo, endpoint, finishReason e ID seguro de respuesta Comparación única: original / copia exportada / imagen de control Resultado de la comparación:
Adjunta una captura recortada del error solo si no contiene imágenes privadas, correo, identificadores de cuenta, claves, pagos ni prompts confidenciales. En una API, una petición mínima anonimizada suele ser más útil que un volcado completo del log.
Preguntas frecuentes
¿Cuál es la solución más rápida si Gemini dice que no puede analizar el archivo?
Vuelve a subirlo una vez, tal como indica la ayuda oficial. Si el mismo error continúa, exporta una copia nueva a PNG o JPEG y compárala en la misma ruta. No sigas repitiendo sin cambiar una variable controlada.
¿Debo convertir siempre la imagen a JPG o PNG?
No. Puede ser una prueba útil si sospechas del contenedor, metadatos o decodificación, pero no soluciona problemas de cuenta, cuota, política, API o servicio. Conserva el original y prueba una copia, no lo sobrescribas.
¿Nano Banana Pro admite imágenes de hasta 100 MB?
La ayuda de Gemini Apps publica límites generales de subida para archivos admitidos, pero no garantiza que toda edición de imagen de ese tamaño se procese correctamente. En la API, los datos enviados en línea tienen otro contrato: el total de la petición está limitado a 20 MB. Primero identifica la superficie.
¿Limpiar la caché o usar incógnito arregla el error?
Puede ayudar a comprobar un problema de sesión, selector o interfaz, pero no hay base para prometer que reparará el archivo o la generación. Hazlo solo cuando la etapa del fallo apunte al navegador y no como sustituto del diagnóstico.
¿Un plan de pago evita estos fallos?
No. Un plan puede cambiar acceso o límites, pero no elimina errores de archivo, petición, servicio, edad, país, idioma o administración de Workspace. Cambia de plan únicamente si el aviso oficial identifica una limitación que el plan resuelve y esa opción te compensa.
¿NO_IMAGE significa que mi contenido está prohibido?
No necesariamente. La API documenta NO_IMAGE por separado de IMAGE_SAFETY y IMAGE_PROHIBITED_CONTENT. Lee el motivo real y no atribuyas una causa de seguridad sin esa señal.
¿Cuándo debo dejar de probar y contactar con soporte?
Cuando una única comparación no cambie el resultado, exista un error persistente de cuenta/proyecto o la integración oculte la respuesta real. Envía el paquete de evidencia anterior sin claves ni imágenes privadas.
En resumen
Un error al procesar imágenes en Nano Banana Pro no tiene una causa universal. La secuencia fiable es: superficie → etapa → señal exacta → una comparación controlada → acción específica. Esa disciplina evita soluciones destructivas, separa una imagen problemática de una ruta problemática y deja un informe que soporte puede utilizar.
Fuentes oficiales consultadas
- Subir y analizar archivos en las aplicaciones de Gemini
- Generar y editar imágenes con las aplicaciones de Gemini
- Comprensión de imágenes en la API de Gemini
- Guía de solución de problemas de Gemini API
- Referencia de GenerateContent
- Estado de Google AI Studio y Gemini API
Información y documentación comprobadas el 20 de julio de 2026. Los nombres de los modelos, los límites, la disponibilidad y el estado del servicio pueden cambiar.
