Migrar de Imagen a Nano Banana en Gemini API: guía paso a paso

¿Qué aprenderás en esta guía?

Según la documentación de Gemini API de Google, los modelos Imagen se han retirado y ya no se pueden usar a través de la API. Por eso, al migrar una integración de generación de imágenes que depende de Imagen, hay que tener en cuenta tres aspectos: el nombre del modelo, el método de llamada y el procesamiento de la respuesta. Esta guía explica cómo revisar estos cambios en una integración existente.

La explicación es una lista de comprobación de migración para aplicaciones y flujos de trabajo que usan la API. La documentación de referencia no incluye comandos de instalación para un lenguaje de programación concreto, versiones de paquetes ni un ejemplo completo de código. Por eso, aquí no se proporciona código de ejemplo ni se describen pasos de interfaz que no figuren en la fuente.

Requisitos y preparación antes de la migración

La migración abarca las integraciones con Imagen que generan imágenes a través de Gemini API. La fuente no especifica requisitos de tipo de cuenta, precio, cuota ni hardware. Antes de empezar, un primer paso suficiente es identificar las llamadas actuales a la API del proyecto y las partes que utilizan la respuesta con imágenes.

Enumera dónde se usan nombres de modelo Imagen en el código, los archivos de configuración o las plantillas de solicitud. Después, anota qué método se utiliza para llamar a la generación de imágenes y qué parte de la respuesta de la API consume la aplicación. Esta revisión permite detectar que quizá no baste con modificar el envío de solicitudes: también puede ser necesario actualizar el código que procesa la respuesta.

Migración a Nano Banana paso a paso

1. Identifica el nombre del modelo actual. Localiza los puntos de la solicitud que usan Imagen y comprueba con qué nombre de modelo llama la aplicación. Google recomienda sustituir los nombres de modelo Imagen por gemini-2.5-flash-image o migrar a modelos Nano Banana 2 como gemini-3.1-flash-image. Al elegir una opción, actualiza el lugar donde la integración selecciona el modelo y comprueba si hay otras solicitudes que utilizan la misma configuración.

2. Cambia el método de llamada. En las notas de migración de Google se indica que se debe usar client.models.generate_content en lugar de client.models.generate_images, el método utilizado con Imagen. Trata este cambio como una comprobación independiente de la actualización del nombre del modelo. Aunque configures el nuevo nombre, la migración no estará completa si la aplicación sigue llamando al método anterior.

3. Revisa el procesamiento de la respuesta. Nano Banana devuelve la respuesta como partes de contenido que incluyen datos de imagen, no como un objeto específico de respuesta de imagen que podría esperarse del uso anterior. Examina qué estructura lee la aplicación en el punto donde recibe la respuesta de la API. Sigue también cómo se transfieren los datos de imagen a los pasos posteriores del procesamiento.

4. Valida el flujo dentro de la aplicación. Después de cambiar el nombre del modelo y el método de llamada, comprueba el flujo de principio a fin con una solicitud de generación de imágenes. No verifiques solo que la solicitud se envíe: comprueba también que los datos de imagen de la respuesta lleguen al siguiente paso que espera la aplicación. Como las notas de migración de Google no ofrecen un caso de prueba concreto ni un ejemplo del resultado esperado, el alcance de la validación dependerá del uso de la aplicación.

5. Actualiza las referencias antiguas y la documentación. Puede que aún queden nombres de modelos Imagen y explicaciones sobre el formato anterior de respuesta en el código o en las notas técnicas del equipo. Actualizarlos reduce el riesgo de que, en tareas de mantenimiento posteriores, se cree una integración nueva con un modelo retirado o un método que ya no se utiliza. Este paso no es una nueva función de la API, sino una recomendación de mantenimiento para que la migración resulte clara.

Errores frecuentes

Cambiar solo el nombre del modelo: La explicación de migración de Google indica que hay que revisar el método y el procesamiento de la respuesta, además del nombre del modelo. Completar las tres comprobaciones es importante para evaluar la integración según el nuevo uso.

Esperar la estructura de respuesta anterior: Como Nano Banana devuelve los datos de imagen en partes de contenido, puede que el código de la aplicación escrito para un objeto de respuesta de imagen anterior no encuentre esos datos en el formato esperado. Incluye el componente que consume la respuesta en el plan de migración.

Dar por sentados requisitos que no aparecen en la fuente: Las notas de migración no especifican un lenguaje o una versión de paquete, precios, cuotas ni condiciones de cuenta. En lugar de presentarlos como requisitos confirmados, comprueba estos detalles en la documentación actualizada de Gemini API antes de implementar el cambio.

Limitar las pruebas al envío de la solicitud: Que la solicitud se envíe correctamente no demuestra por sí solo que los datos de imagen de la respuesta se utilicen bien en los pasos posteriores de la aplicación. Incluye también el procesamiento de la respuesta en las pruebas.

Impacto en los flujos de arquitectura, diseño de interiores y archviz

Para los equipos que usan la generación de imágenes a través de Gemini API en trabajos conceptuales, alternativas de diseño de interiores u otros procesos visuales, este cambio implica actualizar la integración existente. Si hay una automatización vinculada a Imagen, hay que revisar conjuntamente el nombre del modelo, el método de llamada y la parte que consume la respuesta. En las aplicaciones que transfieren los datos de imagen generados a otro paso del flujo del proyecto, también debe comprobarse la compatibilidad de esa transferencia con el nuevo formato de respuesta.

Como la fuente no especifica requisitos de hardware local, no es posible deducir que esta migración requiera una estación de trabajo o GPU concretas. Tampoco se detallan precios ni condiciones de uso. Conviene que los estudios y equipos de visualización revisen por separado las condiciones de uso de la API antes de migrar y prueben si la automatización actual es compatible con los cambios de modelo, método y respuesta.

Próximos pasos

Primero, inventaría las llamadas vinculadas a Imagen. Después, evalúa uno de los nombres de modelo recomendados por Google y el nuevo método de llamada. Por último, comprueba cómo procesa la aplicación las partes de respuesta que contienen los datos de imagen. Para ver ejemplos más detallados, Google remite a su guía de generación de imágenes. Consulta la documentación oficial actualizada para los detalles de implementación que no se explican aquí.

Fuente y licencia

Esta guía se ha adaptado de la guía oficial en inglés de Google sobre el uso de Imagen en Gemini API y la migración a Nano Banana. La fuente está sujeta a la licencia CC BY 4.0, salvo que se indique lo contrario. El texto se ha adaptado al español; no se han añadido ejemplos de código que no aparezcan en la fuente.