Cómo desarrollar con Nano Banana: Tutorial completo para desarrolladores

De @patloeber: Google ha lanzado recientemente Gemini 2.5 Flash Image, un modelo nuevo y potente para la generación y edición de imágenes, también conocido por su nombre clave, Nano Banana. Este modelo introduce capacidades de vanguardia para crear y manipular imágenes, desbloqueando una amplia gama de nuevas aplicaciones.

Esta guía ofrece un recorrido completo para desarrolladores que buscan integrar Gemini 2.5 Flash Image, también conocido como Nano Banana, en sus aplicaciones usando la API de Gemini para desarrolladores.

Esta guía cubrirá:

1. Usar Nano Banana en AI Studio
2. Configuración del proyecto
3. Creación de imágenes
4. Edición de imágenes
5. Restauración de fotos
6. Múltiples imágenes de entrada
7. Edición conversacional de imágenes
8. Mejores prácticas y redacción de instrucciones efectivas
9. Ejemplos de la comunidad e inspiración
10. Recursos

Aquí tienes un ejemplo de lo que construirás en este tutorial:

1prompt = "Restaura y colorea esta imagen de 1932"
2
3response = client.models.generate_content(
4    model="gemini-2.5-flash-image-preview",
5    contents=[prompt, image],
6)

¡Comencemos!

1. Usar Nano Banana en Google AI Studio

Si bien los usuarios finales pueden acceder a Nano Banana en la aplicación Gemini, el mejor entorno para que los desarrolladores prototipen y prueben instrucciones es Google AI Studio. AI Studio es un espacio de juego para experimentar con todos los modelos de IA disponibles antes de escribir cualquier código, y también es el punto de entrada para construir con la API de Gemini.

Puedes usar Nano Banana sin costo dentro de AI Studio. Para comenzar, ve a aistudio.google.com, inicia sesión con tu cuenta de Google y selecciona Nano Banana en el selector de modelos.

Para acceso directo, usa este enlace para iniciar una nueva sesión con el modelo: ai.studio/banana

Consejo

: También puedes codificar al estilo "vibe" aplicaciones web de Nano Banana directamente en AI Studio en

ai.studio/apps , o explorar el código y modificar una de las

aplicaciones existentes .

2. Configuración del proyecto

Para seguir esta guía, necesitarás lo siguiente:

• Una clave de API de Google AI Studio.
• Facturación configurada para tu proyecto.
• El SDK de IA Generativa de Google para Python o JavaScript/TypeScript.

Paso A: Generar una clave de API

Sigue estos pasos:

• En Google AI Studio, haz clic en Obtener clave de API en el panel de navegación izquierdo.
• En la página siguiente, haz clic en Crear clave de API.
• Selecciona un proyecto existente de Google Cloud o crea uno nuevo. Este proyecto se usa para gestionar la facturación del uso de la API.

Una vez que el proceso esté completo, se mostrará tu clave de API. Cópiala y guárdala de forma segura.

Paso B: Habilitar la facturación

Si bien prototipar en AI Studio es gratuito, usar el modelo a través de la API es un servicio de pago. Debes habilitar la facturación en tu proyecto de Google Cloud.

En la pantalla de gestión de claves de API, haz clic en Configurar facturación junto a tu proyecto y sigue las instrucciones en pantalla.

¿Cuánto cuesta Nano Banana?

La generación de imágenes con Nano Banana cuesta $0.039 por imagen *. Por $1, puedes generar aproximadamente 25 imágenes.

* El precio oficial es de $0.30/1M de tokens de entrada y $30/1M de tokens de salida. Una imagen de salida estándar de 1024x1024px consume 1290 tokens, lo que equivale a $0.039 por imagen. Para más detalles, consulta la

tabla de precios de Gemini 2.5 Flash Image .

Paso C: Instalar el SDK

Elige el SDK para tu lenguaje preferido.

1pip install -U google-genai
2# Instala la librería Pillow para manipulación de imágenes
3pip install Pillow

1npm install @google/genai

Los siguientes ejemplos usan el SDK de Python para la demostración. Los fragmentos de código equivalentes para

usar Nano Banana en JavaScript

se proporcionan en este

GitHub Gist .

3. Generación de imágenes a partir de texto

Usa Nano Banana para generar una o más imágenes a partir de una instrucción de texto descriptiva. Usa el ID de modelo gemini-2.5-flash-image-preview para todas las solicitudes a la API.

1from google import genai
2from PIL import Image
3from io import BytesIO
4
5# Configura el cliente con tu clave de API
6client = genai.Client(api_key="TU_CLAVE_API")
7
8prompt = """Crea una imagen fotorrealista de un gato naranja
9con ojos verdes, sentado en un sofá."""
10
11# Llama a la API para generar contenido
12response = client.models.generate_content(
13    model="gemini-2.5-flash-image-preview",
14    contents=prompt,
15)
16
17# La respuesta puede contener tanto datos de texto como de imagen.
18# Itera a través de las partes para encontrar y guardar la imagen.
19for part in response.candidates[0].content.parts:
20    if part.text is not None:
21        print(part.text)
22    elif part.inline_data is not None:
23        image = Image.open(BytesIO(part.inline_data.data))
24        image.save("gato.png")

Salida

El modelo es multimodal, por lo que la respuesta se estructura como una lista de partes que pueden contener datos de texto e imagen (inline_data) intercalados. El código anterior itera a través de estas partes para extraer y guardar la imagen generada.

4. Edición de imágenes con entradas de texto e imagen

Proporciona una imagen existente junto con una instrucción de texto para realizar ediciones. El modelo destaca en mantener la coherencia de los personajes y el contenido de la imagen de entrada.

1from google import genai
2from PIL import Image
3from io import BytesIO
4
5client = genai.Client(api_key="TU_CLAVE_API")
6
7prompt = """Usando la imagen del gato, crea una vista fotorrealista
8a nivel de calle del gato caminando por una acera en un
9vecindario de la Ciudad de Nueva York, con las piernas borrosas de peatones
10y taxis amarillos pasando al fondo."""
11
12image = Image.open("gato.png")
13
14# Pasa tanto la instrucción de texto como la imagen en la lista 'contents'
15response = client.models.generate_content(
16    model="gemini-2.5-flash-image-preview",
17    contents=[prompt, image],
18)
19
20for part in response.candidates[0].content.parts:
21    if part.text is not None:
22        print(part.text)
23    elif part.inline_data is not None:
24        image = Image.open(BytesIO(part.inline_data.data))
25        image.save("gato2.png")

Entrada y Salida

5. Restauración de fotos con Nano Banana

Una de las aplicaciones potentes del modelo es la restauración de fotos. Con una instrucción simple, puede restaurar y colorear fotografías antiguas con resultados impresionantes.

1from google import genai
2from PIL import Image
3from io import BytesIO
4
5client = genai.Client(api_key="TU_CLAVE_API")
6
7prompt = "Restaura y colorea esta imagen de 1932"
8
9image = Image.open("almuerzo.jpg")  # "Almuerzo sobre un rascacielos, 1932"
10
11response = client.models.generate_content(
12    model="gemini-2.5-flash-image-preview",
13    contents=[prompt, image],
14)
15
16for part in response.candidates[0].content.parts:
17    if part.text is not None:
18        print(part.text)
19    elif part.inline_data is not None:
20        image = Image.open(BytesIO(part.inline_data.data))
21        image.save("almuerzo-restaurada.png")

Original y Salida

6. Trabajar con múltiples imágenes de entrada

Puedes proporcionar múltiples imágenes como entrada para tareas de edición más complejas.

1from google import genai
2from PIL import Image
3from io import BytesIO
4
5client = genai.Client(api_key="TU_CLAVE_API")
6
7prompt = "Haz que la niña use esta camiseta. Deja el fondo sin cambios."
8
9image1 = Image.open("nina.png")
10image2 = Image.open("camiseta.png")
11
12response = client.models.generate_content(
13    model="gemini-2.5-flash-image-preview",
14    contents=[prompt, image1, image2],
15)
16
17for part in response.candidates[0].content.parts:
18    if part.text is not None:
19        print(part.text)
20    elif part.inline_data is not None:
21        image = Image.open(BytesIO(part.inline_data.data))
22        image.save("nina-con-camiseta.png")

Entradas 1 y 2 y Salida

7. Edición conversacional de imágenes

Para un refinamiento iterativo, puedes usar una sesión de chat para mantener el contexto a través de múltiples solicitudes. Esto te permite editar imágenes de forma conversacional.

1from google import genai
2from PIL import Image
3from io import BytesIO
4
5client = genai.Client(api_key="TU_CLAVE_API")
6
7# Crea un chat
8chat = client.chats.create(
9    model="gemini-2.5-flash-image-preview"
10)
11
12# Realiza la primera edición de imagen
13response1 = chat.send_message(
14    [
15        "Cambia el gato a un gato bengalí, deja todo lo demás igual",
16        Image.open("gato.png"),
17    ]
18)
19# mostrar / guardar imagen...
20
21# Continúa chateando y editando
22response2 = chat.send_message("El gato debería llevar un sombrero de fiesta divertido")
23# mostrar / guardar imagen...

Entrada y Salidas 1 y 2

Consejo

: Si notas que las características de la imagen comienzan a degradarse o "derivar" después de muchas ediciones conversacionales, es mejor iniciar una nueva sesión con la imagen más reciente y una instrucción más detallada y consolidada para mantener una alta fidelidad.

8. Mejores prácticas y consejos para redactar instrucciones para Nano Banana

Para lograr los mejores resultados con Nano Banana, sigue estas pautas para redactar instrucciones:

• Sé Híper-Específico: Cuantos más detalles proporciones sobre los sujetos, colores, iluminación y composición, más control tendrás sobre el resultado.
• Proporciona Contexto e Intención: Explica el propósito o el estado de ánimo deseado de la imagen. La comprensión del contexto por parte del modelo influirá en sus elecciones creativas.
• Itera y Refina: No esperes perfección en el primer intento. Usa la capacidad conversacional del modelo para hacer cambios incrementales y refinar tu imagen.
• Usa Instrucciones Paso a Paso: Para escenas complejas, divide tu instrucción en una serie de pasos claros y secuenciales.
• Usa un Enfoque Positivo: En lugar de instrucciones negativas como "sin autos", describe la escena deseada de forma positiva: "una calle vacía y desierta sin señales de tráfico".
• Controla la Cámara: Usa términos fotográficos y cinematográficos para dirigir la composición, como "toma gran angular", "toma macro" o "perspectiva desde un ángulo bajo".

Para una inmersión más profunda en las mejores prácticas, revisa la publicación oficial del blog sobre mejores prácticas para redactar instrucciones y la guía de redacción de instrucciones en la documentación.

9. Ejemplos de la comunidad e inspiración

Explora lo que la comunidad está construyendo con Nano Banana:

• Cambio de perspectiva de cámara por @henrydaubrez: Publicación en X
• Aprendizaje con pocos ejemplos para diseño de personajes consistente por @multimodalart: Publicación en X
• Transformaciones de Google Maps "¿Qué ve la flecha roja?" por @tokumin: Publicación en X
• Generación de imágenes a partir de dibujos de figuras de palitos por @yachimat_manga: Publicación en X
• Creación de modelos 3D a partir de imágenes fijas por @deedydas: Publicación en X
• Generación de experiencias de RA basadas en ubicación por @bilawalsidhu: Publicación en X
• Conversión de un mapa 2D en un gráfico 3D por @demishassabis: Publicación en X

10. Recursos y próximos pasos

Esta guía ha cubierto los fundamentos de la construcción con Nano Banana, también conocido como Gemini 2.5 Flash Image. Has aprendido cómo configurar tu entorno, generar y editar imágenes, y aplicar técnicas avanzadas. Ahora estás listo para comenzar a incorporar estas potentes capacidades en tus propios proyectos.

Para lecturas adicionales, consulta los recursos oficiales:

• Google AI Studio
• Documentación de la API de Gemini
• Documentación de la API de Gemini para Nano Banana
• Cómo redactar instrucciones para la generación de imágenes con Gemini 2.5 Flash para obtener los mejores resultados
• Guía de redacción de instrucciones en la documentación de Nano Banana.
• Aplicación Pixshop en AI Studio

Si estás construyendo algo interesante con esto, ¡me encantaría verlo! Siéntete libre de enviarme un mensaje directo o etiquetarme en X: @patloeber.

\Publicación original en [Dev.to