Audiovisual & IAgemini
Gemini 2.5 Flash Image: modelo y uso en API
Gemini 2.5 Flash Image, Nano Banana: identifica el modelo, genera y edita imágenes con la API y revisa su precio y fecha de retirada antes de integrarlo.
- Autor: humAIns
- 7 min de lectura
índice · 7 apartados
Gemini 2.5 Flash Image es el modelo de generación y edición de imágenes de Google conocido como Nano Banana. Se llama desde Gemini API con el identificador gemini-2.5-flash-image; sin embargo, Google ya lo marca como obsoleto y fija su apagado para el 15 de marzo de 2027. Si empiezas un producto nuevo, revisa la migración a Gemini 3.1 Flash Lite Image en vez de construir sobre una integración con fecha de retirada.
Esta guía se centra en la API, el identificador, el coste publicado y el ciclo de vida del modelo, no en el uso de la aplicación de consumo. Para crear imágenes con la interfaz de Gemini, consulta nuestra guía de crear imágenes con Gemini.
Qué es el modelo y qué significan API y Gemini Apps
Gemini 2.5 Flash Image es un modelo multimodal de la Gemini API. Acepta texto e imagen y puede devolver texto e imagen. Su ficha oficial indica límites de 65.536 tokens de entrada y 32.768 de salida, y compatibilidad con generación de imágenes y Batch API. El nombre «Nano Banana» sirve para reconocerlo en la documentación; en una petición programática se usa el identificador exacto.
La API es la interfaz para que un programa envíe contenido y reciba una respuesta del modelo. Google AI Studio permite gestionar proyectos y probar llamadas. Gemini Apps, en cambio, es la aplicación para conversar y crear contenido desde su interfaz. Que un modelo aparezca en la documentación de API no significa que puedas elegirlo directamente en la app ni que los límites o las condiciones sean los mismos.
Entradas, salidas y restricciones que conviene verificar
El modelo permite combinar texto e imagen en la entrada y recibir texto e imagen en la salida. Esto habilita tanto la generación desde una descripción como la edición guiada a partir de una imagen. No es una promesa de control perfecto: examina composición, texto, detalles de producto y artefactos antes de aprobar una pieza.
La ficha vigente lo identifica como modelo obsoleto. La guía de generación de imágenes señala como ruta recomendada para nuevos proyectos Gemini 3.1 Flash Lite Image (gemini-3.1-flash-lite-image), y la página de precios consultada el 16 de noviembre de 2026 anuncia el apagado de Gemini 2.5 Flash Image el 15 de marzo de 2027. No hay una tabla de equivalencias que garantice que otra versión produzca resultados idénticos: compara calidad, formato, comportamiento y coste con ejemplos propios antes de migrar.
Generar una imagen con una llamada de API
La documentación oficial muestra una solicitud generateContent con el modelo gemini-2.5-flash-image. Este ejemplo REST contiene una descripción ficticia y toma la clave desde una variable de entorno: no pegues secretos en el código, el repositorio ni los registros.
curl -X POST \
"https://generativelanguage.googleapis.com/v1/models/gemini-2.5-flash-image:generateContent" \
-H "x-goog-api-key: ${GEMINI_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"contents": [{
"parts": [{"text": "Crea una fotografía de producto de una taza de cerámica azul sobre fondo neutro, luz lateral suave y encuadre cuadrado, sin texto ni logotipos."}]
}],
"generationConfig": {
"imageConfig": {"aspectRatio": "1:1"}
}
}'
Configura GEMINI_API_KEY previamente en el entorno donde ejecutes la petición. La respuesta puede incluir partes de texto e imagen; procesa las partes de salida según el ejemplo de la biblioteca o API que uses. No presupongas que la respuesta completa es un único archivo de imagen.
Edición con una imagen autorizada
Para editar, incluye la imagen junto con una instrucción textual en el contenido de la petición. Por ejemplo, para una foto de producto cuyo uso esté autorizado, pide: «Cambia solo el fondo por un estudio de color crema y conserva el objeto, la etiqueta, el encuadre y la dirección de la luz». La documentación de Google muestra el patrón de texto más imagen codificada como datos de entrada.
Revisa el contorno del objeto, sombras, reflejos, letras y cualquier elemento que deba conservarse. Si el producto debe ser fiel al original, compara la salida con la referencia; una indicación no garantiza una reproducción exacta. Evita cargar imágenes de clientes, personas identificables o material confidencial sin autorización y sin comprobar las reglas de tu organización.
Para el proceso visual desde la app, los prompts de producto y la comprobación de resultados, tienes la guía de crear imágenes con Gemini. Para generar una credencial y guardarla con seguridad, consulta cómo crear una clave para Gemini.
Costes, disponibilidad y migración
La página oficial de precios, consultada el 16 de noviembre de 2026, muestra estos importes para Gemini 2.5 Flash Image:
| Concepto | Precio publicado |
|---|---|
| Entrada de texto o imagen | 0,30 USD por millón de tokens |
| Imagen generada | 0,039 USD por imagen |
| Nivel gratuito | No disponible para este modelo |
| Apagado anunciado | 15 de marzo de 2027 |
Son importes publicados por Google en dólares, no una cotización final en euros ni una estimación de una aplicación completa. El gasto puede depender de los tokens de entrada y las llamadas realizadas; revisa la página de precios y el uso del proyecto antes de poner una integración en producción.
Google recomienda migrar a Gemini 3.1 Flash Lite Image para evitar una interrupción cuando se apague el modelo. La ficha de esta alternativa declara entrada de texto, imagen, vídeo y PDF, salida de imagen y texto, y generación de imágenes. No asumas que todas las funciones, calidades o dimensiones son intercambiables; prueba indicaciones representativas y consulta su coste y límites actuales en la tabla oficial.
| Necesidad | Modelo indicado por Google | Qué hacer |
|---|---|---|
| Mantener una integración existente de Nano Banana | Gemini 2.5 Flash Image (gemini-2.5-flash-image) | Planificar migración antes del apagado anunciado para el 15 de marzo de 2027 |
| Empezar una integración nueva y ligera | Gemini 3.1 Flash Lite Image (gemini-3.1-flash-lite-image) | Validar calidad, modalidades, límites y precio en la ficha vigente |
Esta comparación describe el papel documentado de cada identificador, no garantiza paridad funcional ni resultados idénticos.
Control profesional: encuadre, texto, derechos y datos
Un flujo fiable incluye una revisión visual y contractual. Comprueba encuadre, proporciones, bordes, texto, logotipos y consistencia del producto. Si el resultado contiene información que debe ser exacta —por ejemplo, una cifra en un cartel—, valida cada carácter o incorpora el texto con una herramienta de diseño después de generar la imagen.
Sube solo material que tengas derecho a utilizar. Lee los términos del servicio y las condiciones de datos para el tipo de uso y el proyecto: Google distingue entre servicios gratuitos y de pago, y las condiciones aplicables pueden variar. Además, los términos de Gemini API indican que para ofrecer API clients a usuarios del Espacio Económico Europeo, Suiza o Reino Unido solo se pueden usar servicios de pago. No envíes información personal, confidencial o de clientes sin la autorización y las garantías necesarias.
Los derechos de uso del servicio no resuelven por sí solos la autoría ni los derechos de terceros. Revisa parecidos con obras, marcas o personas y acuerda con tu cliente qué se entrega y quién valida. Nuestra guía sobre derechos del contenido generado con IA explica qué revisar antes de publicar una pieza.
Para adquirir criterio de producción audiovisual y practicar con flujos reales, puedes conocer el curso de IA para audiovisual. No presupone que el curso enseñe específicamente esta API. Si quieres identificar tu punto de partida, haz el test ¿Cuánto te queda?.