Corregir errores de generación de imágenes en Gemini (app y API)

Cuando Gemini no genera una imagen, lo primero es saber dónde estás. Si usas la app de Gemini (web o móvil), lo normal es que falte la sesión, la edad o el cupo, o que Gemini se niegue por política; ve a la lista de la app. Si llamas a la API de Gemini y recibes un código, ese código ya dice si el problema es tuyo (400, 401, 402, 403, 404), de cupo (429) o de Google (500, 503, 504), y si tiene sentido reintentar; ve a la tabla de códigos.

Los códigos y las recomendaciones siguen la página API errors y la guía de solución de problemas de Google, a 5 de octubre de 2026.

La app de Gemini no me deja crear imágenes: seis causas y qué hacer

En la app, la imagen la genera Nano Banana 2 para todo el mundo; Nano Banana Pro solo aparece como «Rehacer con Pro» (Redo with Pro) si tienes un plan de Google AI, según la ayuda de Gemini. Estas son las causas habituales, cada una con su siguiente paso:

1. No has iniciado sesión. Crear imágenes exige una cuenta de Google con sesión iniciada, y la función solo está disponible en los idiomas y países que admite la app. Inicia sesión y vuelve a pedirla.
2. Quieres editar una foto y tienes menos de 18 años. Con cuenta personal se pueden generar imágenes desde los 13 años (o la edad mínima de tu país), pero editar imágenes solo está disponible para mayores de 18.
3. Usas una cuenta de trabajo o de un centro educativo. Estas cuentas pueden tener condiciones y restricciones distintas de las personales; si la opción no aparece, pruébalo con tu cuenta personal o consulta a quien administra la cuenta.
4. Gemini responde «hoy no puedo crear más imágenes para ti». Has llegado al límite de uso. Los límites de la app se miden por cómputo, se renuevan cada 5 horas hasta un tope semanal y son mayores con Google AI Plus, Pro o Ultra; la ayuda de imágenes habla además de una cuota diaria de Nano Banana 2, y al agotarla tampoco puedes rehacer con Pro. Google no publica un número fijo de imágenes por día, así que solo queda esperar a la renovación o tener un plan con más margen. Los detalles por servicio están en qué ofrece Google gratis con Nano Banana en España.
5. Gemini se niega por tratarse de una persona o por seguridad. Es una decisión de política, no un fallo: la app recuerda la política de uso prohibido y puede retirar imágenes cuando sus sistemas detectan una posible infracción, por ejemplo usar la imagen de alguien sin su consentimiento. No hay ajuste que lo cambie, e intentar sortear esas protecciones es en sí una infracción que puede acabar en restricciones de la cuenta. Qué está permitido con fotos de personas lo explica por qué Gemini no genera imágenes de personas.
6. Falla todo, incluso peticiones sencillas. Puede ser una incidencia del servicio; mira cómo saber si Gemini está fallando hoy.

Si la imagen se queda cargando, no aparece en la conversación o la app devuelve un error genérico, la guía paso a paso está en Nano Banana no funciona en Gemini: arreglos para errores de imagen.

Códigos de error de la API de Gemini al generar imágenes

La tabla resume los códigos de error de petición que Google documenta para la API de Gemini, con lo que significan en una llamada de imagen. Los nombres en minúsculas (rate_limit_exceeded, payment_required) son los que devuelve la API de Interactions (Interactions API) en el campo code.

Si llamas a generateContent, verás el mismo problema expresado de otra forma: el estado HTTP más un estado como INVALID_ARGUMENT, RESOURCE_EXHAUSTED o UNAVAILABLE, y los bloqueos aparecen en finishReason o en promptFeedback.blockReason en lugar de en un código de error.

Dos casos que la tabla no cuenta por sí sola. Si el 403 viene con «Your API key was reported as leaked», Google ha bloqueado esa clave por estar expuesta públicamente: genera otra en Google AI Studio y guárdala fuera del código público. Y la API solo funciona desde los países de la lista de regiones disponibles, que incluye España.

Para un 503 persistente con Nano Banana Pro, sigue qué hacer cuando Nano Banana Pro devuelve 503; si el mensaje habla de alta demanda, error de alta demanda en Gemini.

La API bloquea la imagen o no la genera: códigos de bloqueo y de fallo

Aquí la petición llega bien, pero el modelo no entrega la imagen. Google separa los códigos de bloqueo (política, seguridad o derechos) de los errores de generación (un problema estructural en la salida).

Para los bloqueos, la recomendación general de Google es cambiar la entrada y volver a intentarlo. Eso sirve cuando una petición legítima se ha malinterpretado; si lo pedido va contra la política de uso prohibido, no existe versión que pase, y manipular el modelo para saltarse los filtros está prohibido de forma expresa. Los filtros ajustables de safetySettings ya vienen desactivados por defecto en los modelos actuales y las protecciones básicas no se pueden ajustar, por lo que, en la práctica, poner BLOCK_NONE u OFF no levanta un IMAGE_SAFETY ni un IMAGE_PROHIBITED_CONTENT. Además, la API de Interactions no admite ajustes de seguridad personalizados.

En conversaciones de varios turnos con generateContent, el error de firma suele llegar como 400 INVALID_ARGUMENT con un texto del tipo «Image part is missing a thought_signature», como se vio en un caso documentado en el repositorio del SDK de IA de Vercel: el cliente reenviaba la imagen anterior sin su firma. Se arregla devolviendo las partes de la respuesta tal cual se recibieron o usando el historial de chat del SDK oficial.

Error 429 al generar imágenes: límite por minuto, cuota diaria o gasto

Un 429 significa que has superado un límite, pero no siempre el mismo, y la solución depende de cuál:

• rate_limit_exceeded o too_many_requests: límite por minuto. Los modelos de imagen tienen además un límite de imágenes por minuto (IPM). Se resuelve esperando y reintentando con espera exponencial.
• quota_exceeded: cuota diaria. Las peticiones por día (RPD) se reinician a medianoche, hora del Pacífico; antes de eso, reintentar no sirve.
• Límite de gasto: según tu historial de facturación, Google puede aplicar un tope de gasto en ventanas móviles de 10 minutos (10 $ en el nivel 1, 50 $ en el nivel 2, 200 $ en el nivel 3) que también devuelve 429 RESOURCE_EXHAUSTED. Con Nano Banana Pro a 0,134 $ por imagen de 1K o 2K, 10 $ alcanzan para unas 74 imágenes cada 10 minutos (10 / 0,134 = 74,6), sin contar los tokens de entrada ni de razonamiento.

Los límites se aplican por proyecto, no por clave: crear más claves en el mismo proyecto no te da más cupo. Las cifras de cada modelo se consultan en Google AI Studio, porque la página de límites no las publica para los modelos de imagen actuales.

Si el proyecto está en el nivel gratuito, la generación de imágenes no tiene cuota gratuita en ningún modelo de imagen vigente, así que la llamada falla por cuota; en los mensajes que comparten los desarrolladores suele aparecer free_tier_requests con limit: 0. Si ya pagas y sigue saliendo ese límite, sigue Gemini API de pago con free_tier_requests limit 0.

El diagnóstico completo del 429 por nivel y modelo está en cómo solucionar el error 429 de Gemini Image; si el RESOURCE_EXHAUSTED te sale con Nano Banana Pro, en Nano Banana Pro RESOURCE_EXHAUSTED: cuándo reintentar.

Cuándo reintentar: 429, 408 y 5xx con espera exponencial; 400, 402 y 403 nunca

La guía de Google reduce la regla a esto: reintenta solo los errores transitorios (429, 408 y 5xx) y nunca los errores de cliente como 400, 402 o 403, porque indican una clave no válida, saldo de prepago agotado o una petición mal construida, y volverán a fallar igual.

Para los que sí se reintentan, Google recomienda:

• Espera exponencial: 1 s antes del primer reintento y luego 2 s, 4 s, 8 s.
• Variación aleatoria (jitter) en cada espera, para que todos los clientes no reintenten a la vez.
• Un número máximo de reintentos, para no entrar en un bucle infinito.

La guía de Google dice que el SDK de Python reintenta automáticamente los errores transitorios hasta cuatro veces, con una espera inicial de alrededor de 1 segundo y un máximo de 60 segundos. En una prueba del 5 de octubre de 2026 con google-genai 2.28.0 contra un servidor local que respondía 429, no fue así: un genai.Client() sin opciones envió una sola petición y lanzó la excepción al momento. Eso vale para client.models.generate_content; en la misma versión, client.interactions.create sí reintentó el 429 por su cuenta (cuatro peticiones en unos 3 segundos en la misma prueba). Los reintentos se activan con una línea de configuración:

from google import genai
from google.genai import types

client = genai.Client(
    http_options=types.HttpOptions(retry_options=types.HttpRetryOptions())
)

Con esa opción, el mismo 429 generó 5 peticiones (la original y 4 reintentos), con esperas exponenciales desde 1 segundo aproximadamente y un máximo de 60. Los SDK de JavaScript, Go y Java no se probaron. Elige una sola capa de reintentos: o activas HttpRetryOptions o escribes tu propio bucle, pero no las dos cosas, porque una sola petición podría acabar multiplicándose. Ojo también con el coste: las peticiones que fallan con 400 o 500 no se cobran, pero sí cuentan para la cuota.

Parámetros que provocan 400 y 404: ID del modelo, tamaño «1K» y /v1beta

Si la tabla te lleva a un 400 o un 404, revisa estos puntos antes que nada:

• ID del modelo vigente. Usa gemini-3-pro-image (Nano Banana Pro), gemini-3.1-flash-image (Nano Banana 2) o gemini-3.1-flash-lite-image (Nano Banana 2 Lite). Según la página de obsolescencias, gemini-3-pro-image-preview y gemini-3.1-flash-image-preview se cerraron el 25 de junio de 2026, la familia Imagen 4 el 17 de agosto de 2026 y gemini-2.5-flash-image el 2 de octubre de 2026; cualquiera de ellos devuelve ahora model_not_found. Modelos y precios actuales: API de imágenes de Gemini.
• Tamaño con K mayúscula. "1K", "2K" o "4K"; un valor en minúsculas como "1k" se rechaza. Nano Banana 2 Lite solo genera a 1K.
• Versión de la API. Con generateContent, las funciones en beta solo existen en /v1beta; si apuntas a /v1, una opción de imagen puede no estar disponible.
• Rangos de parámetros. Número de candidatos entre 1 y 8; temperature y topP entre 0,0 y 1,0. Google recomienda dejar estos dos en sus valores por defecto con los modelos Gemini 3.x.

Si la respuesta tarda más de lo esperado sin dar error, recuerda que los modelos Gemini 3.x razonan (thinking) por defecto, lo que alarga la latencia y aumenta los tokens; un 504 en esas llamadas suele deberse a un plazo de cliente demasiado corto.

¿Está fallando Gemini hoy? Cómo distinguir una caída de un error tuyo

La señal de una caída es que falla lo que normalmente funciona, sin que hayas cambiado nada. En la app, prueba una petición sencilla en un chat nuevo: si tampoco sale y no ves ningún aviso de límite ni de política, lo más probable es una incidencia temporal, y lo razonable es esperar y volver a intentarlo más tarde.

En la API, las caídas se reconocen por el código: 500, 503 o 504 en peticiones que ayer funcionaban, con el mismo modelo y los mismos parámetros. Un 400, 401, 402, 403 o 404 nunca es una caída de Google; apunta a tu petición, tu clave, tu saldo o el ID del modelo, y esperar no lo arregla.