Google acaba de lanzar Nano Banana Pro, el nombre en clave oficial de Gemini 3 Pro Image, un modelo multimodal de última generación que destaca en la generación de texto a imagen, la edición de imágenes y el control avanzado de la composición. Los desarrolladores ahora acceden a esta potente herramienta programáticamente a través de la API de Gemini. Pequeños detalles de configuración a menudo determinan si su integración tiene éxito o fracasa rápidamente.
Esta guía te acompaña en cada paso para acceder y utilizar la API de Nano Banana Pro de manera efectiva.
¿Qué es Nano Banana Pro y por qué usar su API?
Google DeepMind construyó Nano Banana Pro sobre la base de Gemini 3 Pro. Ofrece salidas de imagen con calidad de estudio que los modelos anteriores no podían igualar. Primero, renderiza texto dentro de imágenes con una precisión excepcional — piensa en logotipos legibles, letreros multilingües o caligrafía estilizada que se alinea perfectamente con la escena. A continuación, soporta hasta 14 imágenes de entrada para la mezcla, manteniendo la consistencia en hasta cinco sujetos. Además, los desarrolladores controlan los ángulos de cámara, la iluminación, la profundidad de campo, la gradación de color e incluso la resolución hasta 4K.
Además, el modelo basa las generaciones en datos de Google Search en tiempo real cuando habilitas la función. Esto asegura la precisión factual para diagramas, infografías o maquetas de productos. Cada salida lleva la marca de agua SynthID para el seguimiento de la procedencia.
Accedes a Nano Banana Pro a través de la API estándar de Gemini, pero seleccionas el identificador de modelo específico (gemini-3-pro-image-preview o su sucesor estable). Este enfoque mantiene tu código compatible con otras variantes de Gemini mientras desbloquea capacidades de imagen de nivel profesional.
Paso a paso: Obtén tu clave API de Gemini
Sigue estas acciones para obtener las credenciales:
Ve a Google AI Studio e inicia sesión con tu cuenta de Google.
Haz clic en el botón "Obtener clave API" en la barra lateral izquierda.
Crea una nueva clave o usa una existente.
Alternativamente, en Vertex AI:
- Abre el panel de control de Vertex AI Studio.
- Selecciona "IA generativa" → "Model Garden".
- Encuentra Nano Banana Pro (listado como Gemini 3 Pro Image).
- Haz clic en "Habilitar API" y genera credenciales.
Guarda la clave de forma segura en variables de entorno. Nunca la codifiques directamente en los archivos fuente.
Llama a la API de Nano Banana Pro desde Google AI Studio (Inicio rápido)
A menudo, se empieza en Google AI Studio para una experimentación rápida. Primero, visita ai.studio/banana-pro. Selecciona "Nano Banana Pro" del menú desplegable de modelos.
Luego, cambia a la pestaña "API" para ver ejemplos de curl automáticamente rellenados con tu clave.
Aquí tienes una solicitud curl básica:
curl https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent \
-H 'Content-Type: application/json' \
-H "x-goog-api-key: YOUR_API_KEY" \
-d '{
"contents": [{
"role": "user",
"parts": [{
"text": "Generate a 4K photorealistic image of a yellow banana floating in space with Earth in the background, add text overlay: \"Nano Banana Pro\""
}]
}],
"generationConfig": {
"responseModal": "IMAGE"
}
}'
Este endpoint sigue siendo el mismo que el de otros modelos Gemini — solo cambia el nombre del modelo.
Usa el SDK oficial de Python para Nano Banana Pro
La mayoría de los desarrolladores prefieren la biblioteca cliente de Python porque maneja reintentos, streaming y tipos MIME automáticamente. Instálala primero:
pip install -U google-generativeai
Configura la biblioteca y genera una imagen:
import google.generativeai as genai
genai.configure(api_key="YOUR_API_KEY")
model = genai.GenerativeModel('models/gemini-3-pro-image-preview')
response = model.generate_content(
"A futuristic cityscape at golden hour with flying cars and the text 'Welcome to 2042' on a billboard, 4K resolution",
generation_config=genai.types.GenerationConfig(
response_mime_type="image/png"
)
)
response.candidates[0].content.parts[0].inline_data.data # base64 image
Guarda la salida así:
with open("output.png", "wb") as f:
f.write(response.candidates[0].content.parts[0].inline_data.data)
El SDK abstrae los detalles de bajo nivel, por lo que te concentras en la ingeniería de prompts.
Manejar la edición de imágenes y las entradas de múltiples imágenes
Nano Banana Pro destaca en tareas de edición. Sube imágenes como parte del prompt. Por ejemplo:
import PIL.Image
img = PIL.Image.open("reference.jpg")
response = model.generate_content(
[img, "Edit this photo: change daytime to dramatic sunset, add bokeh effect, keep the subject unchanged"]
)
Combina múltiples imágenes y texto sin problemas. El modelo mantiene la consistencia del sujeto en todas las referencias.
Características avanzadas: Fundamentación, configuración de seguridad y controles
Habilita la fundamentación de Google Search para inyectar datos en tiempo real:
"systemInstruction": {
"parts": [{"text": "Use search grounding for factual elements"}]
}
Ajusta la configuración de seguridad para bloquear o permitir categorías:
model = genai.GenerativeModel(
'models/gemini-3-pro-image-preview',
safety_settings=[
{"category": "HARM_CATEGORY_DANGEROUS_CONTENT", "threshold": "BLOCK_NONE"}
]
)
Especifica la relación de aspecto y la calidad:
generation_config=genai.types.GenerationConfig(
candidate_count=1,
temperature=0.7,
extra_params={
"aspect_ratio": "16:9",
"quality": "highest"
}
)
Prueba y depura las llamadas a la API de Nano Banana Pro con Apidog
Los comandos curl manuales funcionan para pruebas puntuales, pero Apidog transforma tu flujo de trabajo. Importa la especificación OpenAPI oficial de Gemini en Apidog, y este autogenerará todos los endpoints, incluidas las variantes de Nano Banana Pro.
Así es como te beneficias:
- Visualiza esquemas JSON para solicitudes de generateContent.
- Guarda entornos (claves de dev/staging/prod).
- Encadena solicitudes y afirma respuestas.
- Simula la API localmente para desarrollar sin conexión.
- Genera código cliente en más de 20 lenguajes al instante.
Por ejemplo, crea una nueva solicitud en Apidog, pega el endpoint de Gemini, añade tu clave API como cabecera y envía cargas útiles multipartes complejas con imágenes subidas en segundos. Apidog valida los campos requeridos incluso antes de que hagas clic en "Enviar", previniendo errores 400 comunes.
Muchos equipos informan de ciclos de iteración un 50-70% más rápidos después de cambiar a Apidog para las pruebas de la API de Gemini.
Implementa Nano Banana Pro en Vertex AI para producción
Los usuarios empresariales escalan con Vertex AI. Crea un endpoint personalizado:
- Ve a Vertex AI → Model Garden.
- Implementa "Gemini 3 Pro Image (Nano Banana Pro)".
- Configura el tipo de máquina y el autoescalado.
- Llama al endpoint de predicción con el SDK de Vertex.
Esta ruta proporciona endpoints privados, registro e integración de monitoreo con Cloud Operations.
Precios, límites de tasa y mejores prácticas
Nano Banana Pro cuesta más que los modelos más ligeros debido a sus mayores requisitos de computación. Consulta las tarifas más recientes en la página de precios de la API de Gemini porque se ajustan durante la vista previa.
Implementa una retirada exponencial para los reintentos. Almacena en caché los prompts comunes cuando sea posible. Además, agrupa solicitudes no relacionadas solo si tu caso de uso lo permite — la generación de imágenes aún no soporta el verdadero procesamiento por lotes.
Incluye siempre prompts claros y estructurados. Consulta la guía oficial de prompts para Nano Banana Pro para maximizar la calidad.
Resolución de problemas comunes
Encontrarás errores de "modelo no encontrado" si usas el identificador incorrecto. Confirma que apuntas a gemini-3-pro-image-preview durante la fase de vista previa de pago.
Para fallos de autenticación, regenera tu clave y verifica que no haya espacios al final. Si las imágenes aparecen con marca de agua inesperadamente, recuerda que solo ciertos niveles eliminan el brillo visible.
Cuando las salidas parezcan censuradas, ajusta explícitamente los umbrales de seguridad.
Conclusión
Ahora posees todo el conocimiento para acceder e integrar la API de Nano Banana Pro de manera efectiva. Comienza con Google AI Studio para resultados instantáneos, pasa al SDK de Python para la creación de scripts y aprovecha Apidog para optimizar las pruebas y la depuración.
La combinación de las capacidades de Gemini 3 Pro Image bajo el estandarte de Nano Banana Pro abre nuevas posibilidades para el diseño automatizado, activos de marketing personalizados y herramientas de visualización de datos. Implementa estos pasos, experimenta audazmente y observa cómo tus aplicaciones producen imágenes que rivalizan con las de estudios profesionales.
Descarga Apidog hoy mismo y acelera tu desarrollo con Nano Banana Pro — la diferencia en productividad será evidente después de tu primera sesión.