Tutorial completo para desarrolladores sobre Nano Banana Pro

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

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

Esta guía te explicará las funciones avanzadas de Nano Banana Pro usando la API de Gemini Developer.

Esta guía cubrirá:

**1. Usar Nano Banana Pro en Google AI Studio

1. Configuración del proyecto
2. Inicializar el cliente
3. Generación básica (Los clásicos)
4. El proceso de "razonamiento"
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 de prompting

Nota

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

cookbook de Python

o el

Javascript Notebook

.

1. Usar Nano Banana Pro en Google AI Studio

Si bien los usuarios finales pueden acceder a Nano Banana Pro en la app de Gemini, el mejor entorno para que los desarrolladores prototipen y prueben prompts es Google AI Studio. AI Studio es un área de juegos para experimentar con todos los modelos de IA disponibles antes de escribir código, y también es el punto de entrada para construir 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) en el selector de modelos.

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

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 avanzado de la API de Gemini con todo eso, ¡genial! Solo salta esta sección y ve a la siguiente. De lo contrario, así es como empezar:

Paso A: Obtén tu clave de API

Cuando inicies sesión por primera vez en AI Studio, se debería 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 icono 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. En el momento de publicar esta entrada, 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

Batch API

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

Paso C: Instala el SDK

Elige el SDK para tu lenguaje preferido.

Python:

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

JavaScript / TypeScript:

1npm install @google/genai

Nota

: los siguientes ejemplos usan el SDK de Python como demostración. Fragmentos de código equivalentes para usar Nano Banana en JavaScript se proporcionan en este

JS Notebook

.

3. Inicializar el 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 pasar a 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'], # O solo ['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 chat también es una opción (de hecho, es lo que recomendaría para edición multiciclo). Consulta el octavo ejemplo, 'Polyglot Banana', para ver un ejemplo.

5. El proceso de "razonamiento"

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 echar un vistazo a su cerebro!

Para habilitarlo, establece include_thoughts=True en thinking_config.

1prompt = "Crea una imagen inusual pero realista que pueda 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 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 pasajeros llama
2
3Ahora me estoy enfocando en las llamas. El objetivo es capturarlas como
4pasajeros diarios en un autobús bullicioso en La Paz, Bolivia. Mi plan
5implica un autobús vintage abarrotado de pasajeros divertidos. La imagen
6resaltará detalles como una llama mirando por la ventana,
7otra interactuando con un pasajero, todo 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 Search Grounding. Nano Banana Pro no está anclado en el pasado; puede acceder a datos en tiempo real de Google Search para generar imágenes precisas y actualizadas. ¿Quieres el clima? 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. añade una visualización de lo que 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. A lo grande o a casa: Generación en 4K

¿Necesitas imágenes de calidad de impresión? Nano Banana Pro soporta 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", 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 = "Crea una infografía que explique la teoría de la relatividad general de Einstein adecuada para un estudiante de sexto 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. ¡A mezclar! (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        # ... añade 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 quieres 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í tienes 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 en 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 concreto.

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 extenso análisis literario del poema. Buenas estéticas 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 de prompting para 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 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 prompt en una serie de instrucciones claras y secuenciales.

Usa un enfoque positivo: En lugar de prompts negativos como 'sin coches', 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 á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 debería funcionar igualmente, pero no te arriesgues).

Usa la [Batch API](https://ai.google.dev/gemini-api/docs/image-generation?batch=file#batch-api) para reducir costos y obtener más cuota: La Batch API 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 prompting en la documentación y las mejores prácticas de prompting para Nano Banana publicadas en el blog oficial.

Resumen

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 echa un vistazo al cookbook.