Nano Banana Pro API: modelo oficial, precios, limites y guia rapida

Al 27 de marzo de 2026, Nano Banana Pro API se refiere al modelo de Google gemini-3-pro-image-preview. Si estas construyendo una integracion nueva, el punto de partida mas seguro es la ruta nativa de Gemini para generacion de imagenes, no un alias de terceros y tampoco la capa compatible con OpenAI de Gemini por defecto. La capa de compatibilidad tiene sentido cuando ya existe una aplicacion con forma OpenAI y el objetivo principal es minimizar la reescritura.

Ese orden importa porque la SERP para esta keyword sigue muy fragmentada. Muchas paginas ponen en primer plano Nano Banana Pro API, insignias de precio y ejemplos cortos de curl, pero no explican con claridad el ID oficial del modelo, el requisito de paid tier ni donde viven de verdad tus limites activos. La respuesta mas fiable esta en Google, pero repartida entre la documentacion de image generation, la documentacion de OpenAI compatibility, la pagina de pricing y la pagina de rate limits.

Por eso, la forma mas segura de trabajar esta keyword no es empezar comparando wrappers. Primero confirma el nombre oficial del modelo, despues elige la superficie correcta de API y solo entonces valida billing y limites vigentes. Una vez hecho eso, comparar relays o copiar snippets de un playground de terceros deja de ser una apuesta ciega.

Resumen rapido

Si tu siguiente pregunta ya es de precio, el mejor complemento es Nano Banana Pro API Pricing (English). Si lo que necesitas es una ruta REST mas generica, puedes ir a Gemini Image Generation REST API. Mas abajo tambien dejo enlaces explicitos en ingles para setup, billing y API key cuando no existe equivalente local.

Nano Banana Pro API es el apodo, no el nombre oficial del modelo

Lo primero que esta keyword necesita corregir es el nombre. Nano Banana Pro es el apodo publico que Google usa para la linea premium de imagen de Gemini 3, pero el nombre oficial del modelo en la API es gemini-3-pro-image-preview. La documentacion actual de image generation lo mapea asi:

• Nano Banana 2 = gemini-3.1-flash-image-preview
• Nano Banana Pro = gemini-3-pro-image-preview
• Nano Banana = gemini-2.5-flash-image

Parece una diferencia menor, pero cambia la forma correcta de leer casi todas las paginas de la primera pagina. Muchas paginas de terceros usan aliases propietarios como nano-banana-pro. Puede que funcionen dentro de su propio gateway, pero no son la cadena canonica de Google. Si copias ese alias en una llamada directa a Google, empiezas a depurar la capa equivocada.

El changelog actual de Google indica que gemini-3-pro-image-preview se lanzo el 20 de noviembre de 2025. Esa fecha importa porque muchas paginas antiguas mezclan nombres de prerrelanzamiento, lineas de imagen 2.5 y frases vagas como Gemini 3.0 Pro.

Tambien importa el posicionamiento oficial. La pagina del modelo en DeepMind describe Nano Banana Pro como el modelo de imagen Gemini 3 para precision y control de nivel estudio. La documentacion de image generation dice que esta pensado para produccion profesional de assets y para instrucciones complejas, y que los modelos de imagen Gemini 3 pueden mezclar hasta 14 imagenes de referencia, con limites concretos que varian segun el modelo. Google tambien indica que todas las imagenes generadas incluyen SynthID.

La forma limpia de entenderlo es esta:

• Nano Banana Pro es el apodo comercial.
• gemini-3-pro-image-preview es la cadena oficial que debes esperar en trabajo de API first-party.
• Los aliases de terceros pueden existir, pero son wrappers, no el nombre canonico.

Con eso claro, la siguiente pregunta practica es directa: ¿por que ruta de API deberias empezar?

¿Con que ruta de API conviene empezar?

Para la mayoria de lectores, la respuesta es simple: empieza por la ruta nativa de Gemini API. Es el mejor valor por defecto cuando eres nuevo con el modelo, estas usando HTTP crudo, sigues la documentacion oficial o solo quieres probar la primera llamada correcta.

La razon no es ideologica sino practica. La guia actual de image generation explica la salida de imagenes a traves del contrato nativo generateContent de Gemini. Ahi es donde el mapeo del modelo, el tamano de imagen, la relacion de aspecto y las lineas de imagen Gemini 3 se presentan con mas claridad. Si quieres ir desde “busque la keyword” hasta “ya tengo una llamada correcta a Google”, esta es la superficie mas limpia.

La ruta compatible con OpenAI de Gemini existe y Google la documenta en la pagina de OpenAI compatibility. Permite generar imagenes con gemini-3-pro-image-preview mediante client.images.generate, y resulta util cuando ya tienes una app basada en OpenAI o un SDK que no quieres desmontar. Aun asi, sigue siendo un mal valor por defecto para una integracion nueva porque oculta el contrato nativo de Gemini detras de una capa de compatibilidad.

La division fiable es la siguiente:

• Empieza con Gemini nativo si estas aprendiendo la ruta oficial, construyendo desde cero o depurando solicitudes crudas.
• Empieza con Gemini OpenAI compatibility si conservar la forma del cliente OpenAI es el requisito principal.
• Pasa a relay o provider gateway solo despues de entender el modelo oficial, la linea base oficial de precio y la superficie de billing que estas abstraiendo.

Ese tercer paso importa porque la primera pagina esta llena de paginas de proveedores que parecen el producto. No lo son. Son una via de acceso al producto. Si no entiendes esa diferencia, acabas comparando reglas de gateways ajenos en lugar del comportamiento real de la API de Google.

Donde viven realmente la facturacion, el precio y los limites

La pregunta de la ruta y la pregunta del billing estan mucho mas conectadas de lo que admiten la mayoria de landing pages.

La pagina de billing de Google dice que las cuentas nuevas de Gemini API empiezan en Free Tier y que pasar a Paid Tier requiere vincular una cuenta de billing y prepagar al menos $10. Esa misma pagina tambien menciona un estado temporal de migracion prepay-to-postpay iniciado el 23 de marzo de 2026. La conclusion practica es directa: no asumas que obtener una API key equivale a tener la integracion lista para produccion. Aunque la ruta sea correcta, si el billing del proyecto no esta configurado como corresponde, las llamadas de imagen pueden fallar o comportarse distinto.

La linea base oficial actual segun la pagina de pricing es esta:

Esos numeros deben ser tu primer ancla. Casi todas las paginas de proveedores quieren que pienses antes en su precio empaquetado que en la referencia oficial de Google. Una vez que conoces esa referencia, comparar precios relay ya tiene sentido. Si tu pregunta real es “cual es la ruta mas barata”, te conviene ir directo a Nano Banana Pro Cheap API Alternative (English).

Los limites son la parte donde el contenido viejo hace mas dano. La pagina de rate limits de Google no da un RPM universal que aplique a todos para siempre. En cambio, dice que:

• los limites se aplican por proyecto
• las requests per day se reinician a medianoche del Pacific time
• los modelos preview tienen restricciones mas duras
• los limites activos deben revisarse en AI Studio

Por eso esta pagina no repite un numero fijo de RPM “para todos”. Muchas paginas lo hacen, pero la propia guia de Google es mas condicional. El valor por defecto seguro es tratar AI Studio como el lugar donde se confirma el estado real de tus limites.

Guia rapida: haz tu primera llamada correcta a Nano Banana Pro API

La prueba mas segura es una llamada oficial a Google, un nombre de modelo correcto y una imagen de vuelta. Si el primer objetivo es simplemente demostrar la ruta, no empieces por un wrapper, un pipeline batch o un alias propietario.

Ruta nativa de Gemini

bash
curl -s -X POST \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [
        {
          "text": "Create a clean 16:9 product hero image of a matte black travel mug on a light concrete surface with soft studio lighting and premium ecommerce styling."
        }
      ]
    }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K"
      }
    }
  }'

Esta llamada demuestra directamente la ruta oficial. Usa la cadena canonica del modelo de Google, el contrato nativo actual de Gemini y los campos de configuracion de imagen que Google documenta para Gemini 3.

En la ruta nativa, lo normal es recibir los bytes de la imagen dentro del contenido de la respuesta, no una URL amistosa ya alojada. Esa es otra razon por la que es mejor como primera prueba. Cuando ves la forma real de la respuesta, sabes si estas depurando acceso, seleccion del modelo o la logica de guardado, en lugar de adivinar que capa fallo.

Ruta compatible con OpenAI de Gemini

Si ya tienes un cliente con forma OpenAI y quieres la capa compatible a proposito, la propia documentacion de Google lo soporta:

python
from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
)

result = client.images.generate(
    model="gemini-3-pro-image-preview",
    prompt="Create a clean 16:9 product hero image of a matte black travel mug on a light concrete surface with soft studio lighting and premium ecommerce styling.",
    size="2K",
    n=1,
)

Usa esta ruta cuando el motivo real sea conservar la forma del cliente OpenAI, no simplemente porque el ejemplo parece mas corto.

Despues del primer resultado correcto, el siguiente paso depende de lo que siga sin estar claro:

• Si el bloqueo es billing, ve a Nano Banana Pro Google AI Studio Billing (English).
• Si el bloqueo es API key, ve a Nano Banana Pro API Key (English).
• Si el bloqueo es setup paso a paso, ve a Nano Banana Pro API Setup (English).
• Si quieres una referencia mas general de llamadas REST de imagen, ve a Gemini Image Generation REST API.

Fallas comunes despues de la configuracion

Muy a menudo, esta keyword se convierte en una pregunta de soporte justo despues del primer ejemplo de codigo. Por eso este apartado vale mas que otra lista generica de caracteristicas.

La documentacion oficial de Google explica donde viven billing y limits, pero los hilos de friccion de implementacion muestran mejor los patrones reales. El hilo del Google Developers Forum documenta fallas IMAGE_OTHER que aparecen en AWS Lambda pero no en local. Un hilo muy compartido en Reddit muestra lo facil que es confundir agotamiento de cuota con problemas de capacidad del servicio.

La tabla de triage mas util suele ser esta:

El habito mas importante es depurar capa por capa. Primero el ID oficial del modelo, despues billing, despues la ruta y solo al final la capa compatible o el gateway del proveedor. Ese orden ahorra mas tiempo que cualquier pagina extra de “optimizacion”.

Cuando tiene sentido usar un relay o una pagina de proveedor

Una vez entendida la ruta oficial, las paginas relay pueden tener sentido. No son automaticamente malas, y la SERP esta llena de ellas por algo. Suelen ayudar en cuatro escenarios:

• quieres un gateway con forma OpenAI para varios modelos de imagen
• quieres unificar billing entre varios proveedores
• necesitas un plan de precios de proveedor mas adecuado para tu patron de trafico
• necesitas un onboarding comercial mas rapido que el billing directo de Google

Lo que no deben sustituir es tu entendimiento de la linea base oficial. Si una pagina usa nano-banana-pro en lugar de gemini-3-pro-image-preview, o si solo destaca su precio en creditos, igual deberias saber cual es el modelo oficial subyacente, cuanto cobra Google directamente y de donde salen los limites reales.

Por eso esta pagina mantiene un enfoque official-first. Comparar relays despues esta bien. Empezar por ahi sin entender la superficie oficial de Google es el error.

Si tu siguiente paso real es elegir un gateway mas barato o mas simple, revisa tambien:

• Nano Banana Pro Cheap API Alternative (English)
• How to Call Nano Banana Pro via API (English)
• Nano Banana Pro API Pricing (English)

FAQ

¿Cual es el nombre oficial del modelo de Google para Nano Banana Pro API?

La cadena oficial es gemini-3-pro-image-preview. Nano Banana Pro es el apodo, no el nombre canonico de la API.

¿Tengo que usar la API nativa de Gemini o puedo usar un cliente compatible con OpenAI?

Puedes usar ambas. La ruta nativa de Gemini es el valor por defecto mas seguro para integraciones nuevas. La ruta compatible con OpenAI de Gemini es mejor cuando conservar la forma de cliente OpenAI es el objetivo principal.

¿Donde veo mis limites reales activos?

La pagina actual de rate limits de Google indica que los limites activos deben consultarse en AI Studio. La documentacion publica explica las reglas, pero el estado real de tu proyecto se ve ahi.

¿Necesito billing para usar Nano Banana Pro API en serio?

Si. La documentacion de billing de Google dice que pasar a Paid Tier requiere vincular una cuenta de billing y prepagar al menos $10. No asumas que una API key por si sola te da la ruta de produccion que quieres.

¿Las imagenes generadas incluyen SynthID?

Si. La documentacion de image generation de Google dice que las imagenes generadas incluyen SynthID.

Conclusion

Nano Banana Pro API no es un producto misterioso de terceros. Es el modelo gemini-3-pro-image-preview de Google.

Si empiezas desde cero, usa primero la ruta nativa de Gemini. Si ya tienes un cliente con forma OpenAI y lo principal es reducir el costo de migracion, usa la capa compatible con OpenAI de Gemini de manera intencional. En ambos casos, toma primero como referencia las paginas oficiales de Google sobre precio, billing y limites antes de dejar que los proveedores definan toda la historia.