Cómo utilizar Nano Banana Pro/Nano Banana 2 API: guía paso a paso para desarrolladores

Si has buscado “Nano Banana Pro API”, lo primero que puede resultar confuso es el nombre. El nombre del producto es Nano Banana Pro. El nombre de la API que realmente se utiliza en el código es gemini-3-pro-image. Una vez que esto quede claro, el resto de la configuración resulta mucho menos complicado.

Utiliza Nano Banana Pro cuando la imagen deba mantener una coherencia: texto legible, detalles del producto, referencias a la marca, diseños adaptados a cada mercado o un briefing visual con muchas limitaciones específicas. Si todavía estás probando diez versiones de la misma idea, empieza primero con Nano Banana 2 y pasa a la versión Pro cuando la dirección del proyecto merezca una mayor inversión.

Si tu equipo sigue elaborando propuestas en lugar de lanzar una aplicación, El espacio de trabajo Nano Banana Pro de GlobalGPT Es un lugar práctico para comparar los resultados antes de que un desarrollador conecte la API oficial. Se trata de un atajo creativo en el flujo de trabajo, no de un sustituto de la consola de la API de Google, la facturación, los registros ni los controles empresariales.

Respuesta rápida

Para utilizar Nano Banana Pro a través de una API, crea un proyecto de Google AI Studio o Google Cloud, genera una clave de API de Gemini, instala el SDK de Google Gen AI y llama a gemini-3-pro-image. Empieza con una solicitud sencilla de «texto a imagen». Si todavía estás comprobando el acceso antes de crear una API, el Guía paso a paso de la versión de prueba gratuita de Gemini 3 Pro es una lectura complementaria muy útil.

Qué es realmente la API Nano Banana Pro

Nano Banana Pro es el modelo premium de generación de imágenes nativas de Google perteneciente a la familia de imágenes Gemini. En la documentación para desarrolladores, Google lo denomina Imagen de Gemini 3 Pro. Por eso, la denominación del modelo difiere del nombre comercial.

La API puede generar una imagen a partir de texto, utilizar una o varias imágenes de referencia y editar una imagen existente siguiendo instrucciones escritas. Esto la hace útil para maquetas de productos, variantes publicitarias, diagramas, creatividades localizadas y flujos de trabajo con imágenes en los que el texto que aparece dentro de la imagen debe seguir siendo legible; para la exploración sin código, la Generador de imágenes GlobalGPT es el lugar más adecuado para probar primero la línea creativa.

Nano Banana Pro frente a Nano Banana 2

La elección no tiene tanto que ver con qué nombre suene más novedoso, sino más bien con en qué fase del trabajo te encuentres. «Pro» es para el repaso minucioso. «Nano Banana 2» es para el ciclo de borrador desordenado; si lo que necesitas es esa vía más rápida, lee el Guía de prueba gratuita de Nano Banana 2 antes de diseñar todo el flujo de trabajo en torno a Pro.

Configurar la API con los puntos de entrada reales

Para un prototipo, Google AI Studio suele ser la opción más rápida. Para una aplicación empresarial, utiliza la configuración de Google Cloud en la que tu equipo ya confía, sobre todo si necesitas facturación compartida, control de acceso, registro de actividades o gobernanza de Vertex AI. Si la decisión sobre el acceso depende realmente de los niveles de los planes de Google, compara las ventajas e inconvenientes en el Guía comparativa entre Google AI Plus y Pro antes de considerar que la configuración de la API es el único problema.

La documentación pública es el primer punto de partida más claro. Te permite confirmar que te encuentras en la página de generación de imágenes de Nano Banana, comprobar si la página utiliza la ruta recomendada de la API de Interactions y acceder desde allí a los puntos de entrada de la clave API o de AI Studio.

1. Crea o abre un proyecto de Google AI Studio o de Google Cloud.
2. Crea una clave API Gemini.
3. Guarda la clave como una variable de entorno del lado del servidor.
4. Instala el SDK de Google Gen AI en tu proyecto de backend.
5. Realiza una prueba con baja resolución antes de añadir imágenes de referencia o funciones destinadas al usuario.

La página de claves API también es pública, pero la creación o visualización de una clave depende de tu cuenta de Google y de los permisos del proyecto. Lo más importante: no incluyas esa clave en el JavaScript del front-end. Un navegador o una aplicación móvil debe realizar una llamada a tu back-end, y tu back-end debe realizar una llamada a Gemini.

Tras iniciar sesión, la URL directa de AI Studio redirige a Playground con Nano Banana Pro elegido como gemini-3-pro-image. En esta explicación, AI Studio también señaló un inconveniente práctico: Nano Banana Pro requiere una suscripción a Google AI o una clave de API para que Playground pueda ejecutarlo.

En Obtener código A estas alturas, sigue mereciendo la pena comprobar el botón. Confirma que te encuentras en el flujo de trabajo de desarrollador, pero si el modelo está bloqueado para la cuenta, es posible que el panel de código se abra sin un fragmento de código completo y ejecutable. Se trata de una indicación de configuración, no de un error del programa.

export GEMINI_API_KEY="TU_CLAVE_API"

Generar una primera imagen

La primera solicitud debe ser deliberadamente sencilla. Estás comprobando la autenticación, el acceso al modelo, el formato de la respuesta y la gestión de archivos. Las tareas más complejas relacionadas con las indicaciones pueden esperar hasta que todo esté a punto.

from google import genai
from google.genai import types
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

respuesta = cliente.modelos.generate_content(
    modelo="gemini-3-pro-image",
    contenido=(
 "Crea una maqueta limpia de una taza de viaje de acero inoxidable"
 "sobre un escritorio blanco. Añade la etiqueta legible: MORNING LAB."
    ),
    config=types.GenerateContentConfig(
 response_modalities=["TEXT", "IMAGE"]
    ),
)

for part in response.candidates[0].content.parts:
    if part.text:
 print(part.text)
    elif part.inline_data:
 with open("nano-banana-pro-output.png", "wb") as f:
 f.write(part.inline_data.data)

Esta indicación solicita una maqueta sencilla de un producto con texto legible. Esto te da una idea rápida de tres aspectos importantes en el trabajo real: el realismo del objeto, la composición y si el modelo es capaz de mantener nítido un texto breve. Para ajustar la indicación sin modificar las credenciales, prueba con el mismo briefing en El espacio de trabajo Nano Banana Pro de GlobalGPT primero.

Editar imágenes con referencias

La edición basada en referencias es donde Nano Banana Pro empieza a demostrar su valía. En lugar de pedir una nueva imagen desde cero, le das una imagen al modelo y le indicas exactamente qué puede cambiar y qué debe permanecer igual.

Si no eres desarrollador, lee este bloque como un ejemplo de flujo de trabajo y no como algo que tengas que ejecutar. El nombre del archivo product-reference.png significa simplemente “la imagen de tu producto actual”. Si tu tarea principal consiste en comparar modelos de imágenes, el concepto más amplio Prueba de alternativas al Gemini 3 Pro puede ayudarte a decidir si la versión Pro merece la pena a pesar de la configuración adicional que requiere.

from google import genai
from google.genai import types
from PIL import Image
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
reference = Image.open("product-reference.png")

respuesta = cliente.modelos.generate_content(
    modelo="gemini-3-pro-image",
    contenido=[
 referencia,
 (
 "Mantén sin cambios la forma de la taza, el asa y la ubicación del logotipo."
            "Cambia el fondo por una encimera de cocina clara, añade una cálida luz matutina,"
 "y mantén todo el texto nítido y legible."
 ),
    ],
    config=types.GenerateContentConfig(response_modalities=["TEXT", "IMAGE"]),
)

Una buena indicación de edición se parece mucho a los comentarios que se le hacen a un diseñador: mantén esto, cambia aquello, no muevas el logotipo, haz que el texto se lea bien. Las instrucciones vagas, como “dale un toque de lujo”, suelen hacer que se desperdicien tiradas, ya que dejan demasiado margen para que el modelo tenga que adivinar qué se quiere.

Fijación de precios y control de costes

Utiliza la página de precios de Google como fuente de referencia antes de publicar cifras de presupuesto fijas. Según se ha comprobado el 21 de julio de 2026, Google incluye Nano Banana Pro dentro de Gemini 3 Pro Image y distingue entre el coste del texto y el razonamiento y el coste de la generación de imágenes.

Costes de generación de imágenes de la API, verificados el 21 de julio de 2026

El modelo de costes práctico es sencillo: haz un borrador más barato y perfecciona el resultado con cuidado. Deja que Nano Banana 2 se encargue de las primeras variaciones y, a continuación, envía las indicaciones y referencias más sólidas a Nano Banana Pro para obtener las imágenes definitivas. Además, limita la resolución según el nivel de usuario y evita las generaciones repetidas cuando la indicación no haya cambiado; si quieres una vía de borradores orientada al producto, Nano Banana 2 en GlobalGPT es la opción más ligera que hay que probar primero.

Notas de producción

Una vez que los usuarios puedan generar imágenes a partir de tu producto, necesitarás medidas de control. Las API de imágenes pueden resultar caras en poco tiempo, y es necesario que los fallos se puedan explicar sin revelar los detalles sin procesar del proveedor. Los equipos que aún están decidiendo quién necesita acceso de pago a la IA también pueden comparar los flujos de trabajo basados en suscripciones en el ChatGPT: Guía para la elaboración de un plan de negocio.

• Almacenar las claves en el servidor: No envíes la clave API Gemini desde un navegador o un cliente móvil.
• Registra la información necesaria para la depuración: ID del modelo, hash de la solicitud, tamaño de la salida, latencia, ID de usuario y estado del resultado.
• Establecer cuotas: limitar el número de imágenes por usuario, espacio de trabajo y periodo de facturación.
• Vuelve a intentarlo con cuidado: Reintentar los fallos temporales, pero no reintentar los errores de política o de cuota en un bucle.
• Establecer las normas de almacenamiento: Averigua cuánto tiempo conservas las imágenes generadas y las referencias subidas.
• Escribe mensajes de error útiles: Indica al usuario si el problema se debe al acceso, al formato del archivo, a la cuota o a la política de mensajes.

Dónde encaja GlobalGPT

GlobalGPT encaja mejor antes o junto a la compilación de la API. Un diseñador puede comparar Nano Banana Pro con Nano Banana 2, GPT Image, Flux y otros modelos de imágenes en un único espacio de trabajo, para luego pasar el patrón de prompt ganador al desarrollador.

Para claves API oficiales, facturación, registros, acceso empresarial o enrutamiento de Vertex AI, sigue utilizando la plataforma para desarrolladores de Google. Para comparar ideas más rápidamente y tener menos pestañas abiertas durante el desarrollo de las indicaciones, El espacio de trabajo del generador de imágenes de GlobalGPT puede hacer que los primeros pasos resulten menos torpes.

PREGUNTAS FRECUENTES

¿La API Nano Banana Pro es lo mismo que Gemini 3 Pro Image?

Para el trabajo de desarrollo, sí. Google describe el Nano Banana Pro como «Gemini 3 Pro Image», y el identificador de modelo de la API es gemini-3-pro-image.

¿Debería usar el Nano Banana Pro o el Nano Banana 2?

Utiliza Nano Banana Pro para las imágenes finales que requieran un mayor control, texto legible, referencias o coherencia de marca. Utiliza Nano Banana 2 para borradores más rápidos y un proceso de iteración más económico.

¿Puedo llamar a Nano Banana Pro directamente desde el JavaScript del frontend?

No. Mantén la clave de la API en el lado del servidor, canaliza las solicitudes a través de tu backend y aplica las cuotas de usuario antes de enviar las solicitudes a la API de Gemini.

¿Sustituye GlobalGPT a la API oficial de Google?

El n.º GlobalGPT resulta útil para realizar pruebas rápidas y comparar creatividades de distintos modelos, pero las claves de API oficiales, la facturación, los registros y los controles empresariales se gestionan en la plataforma para desarrolladores de Google.

¿Cómo puedo calcular los costes de la API Nano Banana Pro?

Utiliza la página actual de precios de la API Gemini de Google y realiza una estimación en función del modelo, la resolución de salida y el volumen de imágenes. Una estrategia habitual para controlar los costes consiste en realizar primero los bocetos con el modelo más económico y, a continuación, utilizar Nano Banana Pro para los activos finales seleccionados.