Tutorial completo para desarrolladores sobre Nano Banana Pro

Descubre cómo las funciones avanzadas de este modelo de IA de nueva generación —incluyendo pensamiento, búsqueda contextual y una impresionante salida en 4K— te permitirán crear aplicaciones complejas y creativas.

Mientras que el modelo Flash (Nano Banana) ofreció velocidad y accesibilidad, la versión Pro introduce capacidades de "pensamiento", búsqueda contextual y salida en 4K de alta fidelidad. ¡Es hora de volverse loco con tareas creativas complejas!

Esta guía te llevará a través de las funciones avanzadas de Nano Banana Pro usando la API para desarrolladores de Gemini.

**Esta guía cubrirá:

**1. Uso de Nano Banana Pro en Google AI Studio

1. Configuración del proyecto
2. Inicialización del cliente
3. Generación básica (Los clásicos)
4. El proceso de "pensamiento"
5. Búsqueda contextual
6. Generación en 4K de alta resolución
7. Capacidades multilingües
8. Mezcla avanzada de imágenes
9. Demos exclusivas de Pro
10. Mejores prácticas y consejos para prompts

Nota

: para una versión interactiva de esta publicación, consulta el

recetario de Python

o el

Cuaderno de JavaScript

de AI Studio.

1. Uso de Nano Banana Pro en Google AI Studio

Los usuarios finales pueden acceder a Nano Banana Pro en la app de Gemini, pero el mejor entorno para que los desarrolladores prototipen y prueben prompts es Google AI Studio. AI Studio es un campo 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 desarrollar con la API de Gemini.

Puedes usar Nano Banana Pro dentro de AI Studio. Para empezar, ve a aistudio.google.com, inicia sesión con tu cuenta de Google y selecciona Nano Banana Pro (Gemini 3 Pro Image) del selector de modelos.

A diferencia de Nano-Banana, la versión Pro no tiene un nivel gratuito, lo que significa que necesitas seleccionar una clave de API con facturación habilitada (consulta la sección "Configuración del proyecto" a continuación).

Consejo

: También puedes codificar aplicaciones web de Nano Banana directamente en AI Studio en

ai.studio/apps

, o explorar el código y remezclar 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 Google Gen AI para Python o JavaScript/TypeScript.

Si ya eres un usuario experto de la API de Gemini y tienes todo eso, ¡genial! solo salta esta sección y pasa a la siguiente. De lo contrario, así es cómo empezar:

Paso A: Obtén tu clave de API

Cuando inicies sesión por primera vez en AI Studio, se deberían crear automáticamente un proyecto de Google Cloud y una clave de API.

Abre la pantalla de administración de claves de API y haz clic en el ícono de "copiar" para copiar tu clave de API.

Paso B: Habilita la facturación

Dado que Nano Banana Pro no tiene un nivel gratuito, debes habilitar la facturación en tu proyecto de Google Cloud.

En la pantalla de administració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 Pro?

La generación de imágenes con Nano Banana Pro es más cara que la versión Flash, especialmente para imágenes en 4K. Al momento de publicar este artículo, una imagen de 1K o 2K cuesta $0.134, mientras que una de 4K cuesta $0.24 (más el costo de tokens de la entrada y la salida de texto).

Consulta los precios en la documentación para conocer los detalles más recientes.

Consejo profesional

: Para ahorrar un 50% en tus costos de generación, puedes usar la

API por lotes

. A cambio, es posible que tengas que esperar hasta 24 horas para obtener tus imágenes.

Paso C: Instala el SDK

Elige el SDK para tu lenguaje preferido.

Python:

1pip install -U google-genai
2# Install the Pillow library for image manipulation
3pip install Pillow

JavaScript / TypeScript:

1npm install @google/genai

Nota

: 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

Cuaderno de JavaScript

.

3. Inicialización del cliente

Para usar el modelo Pro, necesitarás usar el ID de modelo gemini-3-pro-image-preview.

1from google import genai
2from google.genai import types
3
4# Inicializa el cliente
5client = genai.Client(api_key="YOUR_API_KEY")
6
7# Establece el ID del modelo
8PRO_MODEL_ID = "gemini-3-pro-image-preview"

4. Generación básica (Los clásicos)

Antes de entrar en lo sofisticado, veamos una generación estándar. Puedes controlar la salida usando response_modalities (para obtener texto e imágenes o solo imágenes) y aspect_ratio.

1prompt = "Crea una imagen fotorrealista de un gato siamés con un ojo izquierdo verde y uno derecho azul"
2aspect_ratio = "16:9" # "1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9" or "21:9"
3
4response = client.models.generate_content(
5    model=PRO_MODEL_ID,
6    contents=prompt,
7    config=types.GenerateContentConfig(
8        response_modalities=['Text', 'Image'], # Or just ['Image']
9        image_config=types.ImageConfig(
10            aspect_ratio=aspect_ratio,
11        )
12    )
13)
14
15# Muestra la imagen
16for part in response.parts:
17    if image:= part.as_image():
18        image.save("cat.png")

El modo de chat también es una opción (de hecho, es lo que recomiendo para edición en múltiples turnos). Consulta el ejemplo 8, "Polyglot Banana", para ver un ejemplo.

5. El proceso de "pensamiento"

Nano Banana Pro no solo dibuja; piensa. Esto significa que puede razonar a través de tus prompts más complejos y retorcidos antes de generar una imagen. ¿Y la mejor parte? ¡Puedes asomarte a su cerebro!

Para habilitar esto, establece include_thoughts=True en thinking_config.

1prompt = "Crea una imagen inusual pero realista que podría volverse viral"
2aspect_ratio = "16:9"
3
4response = client.models.generate_content(
5    model=PRO_MODEL_ID,
6    contents=prompt,
7    config=types.GenerateContentConfig(
8        response_modalities=['Text', 'Image'],
9        image_config=types.ImageConfig(
10            aspect_ratio=aspect_ratio,
11        ),
12        thinking_config=types.ThinkingConfig(
13            include_thoughts=True # Habilita los pensamientos
14        )
15    )
16)
17
18# Muestra la imagen y los pensamientos
19for part in response.parts:
20  if part.thought:
21    print(f"Pensamiento: {part.text}")
22  elif image:= part.as_image():
23    image.save("viral.png")

Y deberías obtener algo como:

1## Imaginando a las llamas viajeras
2
3Ahora me estoy enfocando en las llamas. El objetivo es capturarlas como
4viajeras diarias en un autobús bullicioso en La Paz, Bolivia. Mi plan
5incluye un autobús antiguo lleno de pasajeros divertidos. La imagen
6resaltará detalles como una llama mirando por la ventana,
7otra interactuando con un pasajero, mientras la gente toma
8fotos.
9
10[IMAGE]
11
12## Visualizando el concepto
13
14Ahora estoy completamente inmerso en el escenario solicitado. Mi enfoque
15principal está en los aspectos 'inusuales pero realistas'. La escena
16está empezando a tomar forma con los elementos clave establecidos.

Esta transparencia te ayuda a entender cómo el modelo interpretó tu solicitud. ¡Es como tener una conversación con tu artista!

6. Búsqueda contextual (Magia en tiempo real)

Una de las características más revolucionarias es la búsqueda contextual. Nano Banana Pro no está atascado en el pasado; puede acceder a datos en tiempo real de Google Search para generar imágenes precisas y actualizadas. ¿Quieres el clima? Ahí lo tienes.

Por ejemplo, puedes pedirle que visualice el pronóstico del tiempo actual:

1prompt = "Visualiza el pronóstico del tiempo actual para los próximos 5 días en Tokio como un gráfico meteorológico limpio y moderno. agrega un visual sobre qué debería usar cada día"
2
3response = client.models.generate_content(
4    model=PRO_MODEL_ID,
5    contents=prompt,
6    config=types.GenerateContentConfig(
7        response_modalities=['Text', 'Image'],
8        image_config=types.ImageConfig(
9            aspect_ratio="16:9",
10        ),
11        tools=[{"google_search": {}}] # Habilita Google Search
12    )
13)
14
15# Guarda la imagen
16for part in response.parts:
17    if image:= part.as_image():
18        image.save("weather.png")
19
20# Muestra las fuentes (siempre debes hacerlo)
21print(response.candidates[0].grounding_metadata.search_entry_point.rendered_content)

7. Todo o nada: Generación en 4K

¿Necesitas imágenes de calidad de impresión? Nano Banana Pro admite resolución 4K. Porque a veces, más grande es mejor.

1prompt = "Una foto de un roble experimentando cada estación"
2resolution = "4K" # Opciones: '1K', '2K', '4K', ten cuidado, las minúsculas no funcionan.
3
4response = client.models.generate_content(
5    model=PRO_MODEL_ID,
6    contents=prompt,
7    config=types.GenerateContentConfig(
8        response_modalities=['Text', 'Image'],
9        image_config=types.ImageConfig(
10            aspect_ratio="1:1",
11            image_size=resolution
12        )
13    )
14)

Nota

: La generación en 4K tiene un costo más alto, ¡úsala con sabiduría!

8. Polyglot Banana (Capacidades multilingües)

El modelo puede generar e incluso traducir texto dentro de imágenes en más de una docena de idiomas. Es básicamente un traductor universal para tus ojos.

1# Genera una infografía en español
2message = "Haz una infografía que explique la teoría de la Relatividad General de Einstein adecuada para un estudiante de 6º grado en español"
3
4response = chat.send_message(message,
5    config=types.GenerateContentConfig(
6        image_config=types.ImageConfig(aspect_ratio="16:9")
7    )
8)
9
10# Guarda la imagen
11for part in response.parts:
12    if image:= part.as_image():
13        image.save("relativity.png")

1# Tradúcela al japonés
2message = "Traduce esta infografía al japonés, manteniendo todo lo demás igual"
3response = chat.send_message(message)
4
5# Guarda la imagen
6for part in response.parts:
7    if image:= part.as_image():
8        image.save("relativity_JP.png")

9. ¡Mezcla todo! (Mezcla avanzada de imágenes)

Mientras que el modelo Flash puede mezclar hasta 3 imágenes, el modelo Pro puede manejar hasta 14 imágenes! ¡Eso es toda una fiesta en un solo prompt! Perfecto para crear collages complejos o mostrar toda tu línea de productos.

1# Mezcla múltiples imágenes
2response = client.models.generate_content(
3    model=PRO_MODEL_ID,
4    contents=[
5        "Una foto grupal de oficina de estas personas, están haciendo caras graciosas.",
6        PIL.Image.open('John.png'),
7        PIL.Image.open('Jane.png'),
8        # ... agrega hasta 14 imágenes
9    ],
10)
11
12# Guarda la imagen
13for part in response.parts:
14    if image:= part.as_image():
15        image.save("group_picture.png")

Nota

: Si deseas una fidelidad muy alta para tus personajes, limítate a 5, que ya es más que suficiente para una noche de fiesta.

10. ¡Hora de lucirse! (Demos exclusivas de Pro)

Aquí hay algunos ejemplos de lo que es posible solo con Nano Banana Pro. Prepárate para sorprenderte:

Pixel art personalizado (Búsqueda contextual)

Prompt

: "Busca en la web y luego genera una imagen de perspectiva isométrica, pixel art detallado que muestre la carrera de Guillaume Vernade"

Esto usa la búsqueda contextual para encontrar información específica sobre una persona y la visualiza en un estilo específico.

Integración de texto complejo

Prompt

: "Muéstrame una infografía sobre cómo funcionan los sonetos, usando un soneto sobre bananas escrito en ella, junto con un análisis literario extenso del poema. Con buena estética vintage"

El modelo puede generar texto coherente y extenso e integrarlo perfectamente en un diseño complejo.

Maquetas de alta fidelidad

Prompt

: "Una foto de un programa para el espectáculo de Broadway sobre jugadores de TCG en un buen asiento de teatro, es profesional y bien hecho, brillante, podemos ver la portada y una página que muestra una foto del escenario."

Crea maquetas fotorrealistas de materiales impresos con iluminación y textura precisas.

11. Mejores prácticas y consejos para prompts de Nano Banana y Nano Banana Pro

Para obtener los mejores resultados con los modelos Nano Banana, sigue estas pautas de prompting:

Sé hiperespecífico: Cuantos más detalles proporciones sobre 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 prompt en una serie de instrucciones claras y secuenciales.

Usa un enfoque positivo: En lugar de prompts negativos como "sin autos", describe la escena deseada de manera 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 ángulo bajo".

Usa la búsqueda contextual a tu favor: Cuando sepas que quieres que el modelo use datos en tiempo real o del mundo real, sé muy preciso al respecto. "Busca en la web sobre el último partido del Olympique Lyonnais y haz una infografía" funcionará mejor que solo "una infografía de los últimos partidos del OL" (que aún debería funcionar, pero no te arriesgues).

Usa la API por lotes para reducir tus costos y obtener más cuota: La API por lotes es una forma de enviar lotes pequeños o muy grandes de solicitudes juntas. Pueden tardar hasta 24 horas en procesarse, pero a cambio puedes ahorrar un 50% en tus costos de generación. ¡Y la cuota también es mayor!

Para una inmersión más profunda en las mejores prácticas, consulta la guía de prompts en la documentación y las mejores prácticas de prompts para Nano Banana publicadas en el blog oficial.

Conclusión

Nano Banana Pro (Gemini 3 Pro Image) abre una nueva frontera para la generación de imágenes con IA. Con su capacidad de pensar, buscar y renderizar en 4K, es una herramienta para creadores serios (y diversión seria).

¿Listo para probarlo? Dirígete a Google AI Studio, prueba o personaliza nuestras Apps o consulta el recetario.