Saltar al contenido principal

Nano Banana en Vertex AI: modelos vigentes, costes y errores

En Vertex AI, usa gemini-nano-banana-2.1 en global (0,0504 $ por imagen 2K); Nano Banana 2 tiene soporte hasta 2027 y los IDs preview ya no responden.

LaoZhang AI TeamPublicadoActualizado 19 min de lectura
En esta página
Nano Banana 2.1 en Vertex AI: modelo global, autenticación Cloud y coste 2K

Lo que funciona hoy en Vertex AI

Actualización del 8 de octubre de 2026. Nano Banana 2.1 (gemini-nano-banana-2.1) es GA en Vertex AI desde el 6 de octubre, solo en la location global, y es el ID con el que conviene empezar un proyecto nuevo. Nano Banana 2 (gemini-3.1-flash-image) sigue siendo GA en Vertex con soporte hasta el 28 de mayo de 2027 o después, así que allí no hay prisa por migrar; en la Gemini API con clave de AI Studio, en cambio, ya figura como obsoleto, aunque sin fecha de cierre. También ha cambiado la fecha de gemini-2.5-flash-image en la Gemini API, donde las propias páginas de Google no coinciden. Las tablas, el código y los costes de abajo ya incluyen 2.1.

A 8 de octubre de 2026, una llamada a Nano Banana por Vertex AI funciona si cumple cuatro cosas: usa un ID de modelo GA (gemini-nano-banana-2.1 para Nano Banana 2.1, gemini-3.1-flash-image para Nano Banana 2, gemini-3-pro-image para Nano Banana Pro, gemini-3.1-flash-lite-image para Nano Banana 2 Lite), apunta a la location global (o us/eu solo con Nano Banana 2), se autentica con credenciales de Google Cloud y crea el cliente del SDK google-genai con enterprise=True. Si tu código viene de 2025, revisa primero el ID: los modelos -preview de entonces se retiraron de la plataforma el 17 de julio de 2026.

Lo que ha cambiado desde 2025:

  • Nombre. El 22 de abril de 2026 Vertex AI pasó a formar parte de Gemini Enterprise Agent Platform. La consola de prompts se llama ahora Agent Studio (antes Vertex AI Studio) y la documentación vive en docs.cloud.google.com/gemini-enterprise-agent-platform/, según las notas de la versión. El host de la API sigue siendo aiplatform.googleapis.com y las URL antiguas de la documentación de Vertex AI siguen abriendo.
  • Modelos. Nano Banana 2 y Nano Banana Pro son GA desde el 28 de mayo de 2026 y Nano Banana 2.1 desde el 6 de octubre de 2026; gemini-3.1-flash-image-preview y gemini-3-pro-image-preview están retirados.
  • SDK. En google-genai el indicador actual es enterprise=True (o la variable GOOGLE_GENAI_USE_ENTERPRISE=True). El antiguo vertexai=True sigue funcionando como indicador heredado y lleva al mismo endpoint.
  • Precio. El precio de lista en global es idéntico al de la Gemini API con clave de AI Studio, también para 2.1. Pasar a Vertex no abarata nada; lo que cambia es la autenticación, la capacidad, los controles y, en el caso de Nano Banana 2, el calendario de soporte.

¿Vertex AI o una clave de AI Studio?

Los mismos modelos se pueden llamar por dos plataformas de Google. La diferencia no está en la calidad de la imagen, sino en todo lo que rodea a la llamada:

Vertex AI (Agent Platform)Gemini Developer API (clave de AI Studio)
AutenticaciónCredenciales de Google Cloud (ADC, cuenta de servicio, IAM); clave de API solo en el modo expressClave de API
Endpointaiplatform.googleapis.com en global; aiplatform.us.rep.googleapis.com o aiplatform.eu.rep.googleapis.com en us/eugenerativelanguage.googleapis.com
Cliente Pythongenai.Client(enterprise=True, project=..., location="global")genai.Client(api_key=...)
Precio de lista de Nano Banana 2.1, Nano Banana 2 y ProIgual que en AI Studio con global; Nano Banana 2 cuesta un 10 % más en us/euSolo nivel de pago: el nivel gratuito no incluye ninguno de los tres
Estado de Nano Banana 2 (gemini-3.1-flash-image)GA, con soporte hasta el 28 de mayo de 2027 o despuésObsoleto sin fecha de cierre; Google pide migrar a gemini-nano-banana-2.1
CapacidadStandard PayGo compartido y sin cifra publicada para imagen, Flex (salvo 2.1), Batch y Provisioned ThroughputCuotas propias de la Gemini API
Controles de empresaResidencia de datos, CMEK, VPC-SC y AXTPara estos controles, Google remite a Agent Platform
Retirada de gemini-2.5-flash-image15 de marzo de 202715 de marzo de 2027 en la tabla de retiradas, pero la página de precios aún avisa del 2 de octubre de 2026
Crédito de prueba de 300 $ de Google CloudNo figura entre las exclusionesExcluido de forma expresa

La propia guía de Google lo resume así: la mayoría de desarrolladores deberían quedarse en la Gemini Developer API salvo que necesiten controles de empresa concretos (Gemini API: migrar a Google Cloud). Traducido a decisiones:

  • Vertex compensa si tu empresa exige facturación e IAM de Google Cloud, si necesitas procesar las imágenes en la UE (eu, solo con Nano Banana 2), si te piden CMEK o un perímetro de VPC Service Controls, o si necesitas capacidad reservada con Provisioned Throughput.
  • Si ya tienes Nano Banana 2 en producción, Vertex te da un horizonte publicado: soporte hasta el 28 de mayo de 2027 o después, frente a un «obsoleto, sin fecha» en la tabla de retiradas de la Gemini API. Puedes migrar a 2.1 con calma. Para código nuevo, en cualquiera de las dos plataformas, empieza con gemini-nano-banana-2.1.
  • Si dependes de gemini-2.5-flash-image, cambiar de plataforma ya no te compra un plazo claro. Agent Platform lo mantiene hasta el 15 de marzo de 2027 y la tabla de retiradas de la Gemini API da ahora la misma fecha, pero la página de precios de la Gemini API sigue avisando de un cierre el 2 de octubre de 2026. Con dos páginas de Google en desacuerdo, no planifiques con la fecha más larga: migra a gemini-3.1-flash-lite-image, el reemplazo que Google indica, o a gemini-nano-banana-2.1, que en 1K cuesta lo mismo por imagen.
  • Quédate con la clave de AI Studio si nada de lo anterior aplica. La comparación general está en Gemini API o Vertex AI: cómo elegir, comparar costes y migrar, y el código con clave de API en Nano Banana API: clave, documentación y tutorial con código.

Modelos, locations y fechas de retirada

Esta es la matriz que decide si una llamada puede funcionar. Los datos salen de las fichas de cada modelo y de la tabla de versiones de Agent Platform, a 8 de octubre de 2026:

ModeloID en Agent PlatformEstadoLocationsResoluciones de salidaRetirada prevista
Nano Banana 2.1gemini-nano-banana-2.1GA desde el 06-10-2026Solo global1K, 2K, 4KSin fecha anunciada; aviso con 45 días de antelación como mínimo
Nano Banana 2gemini-3.1-flash-imageGA desde el 28-05-2026global, us, eu512, 1K, 2K, 4K28 de mayo de 2027 o después
Nano Banana Progemini-3-pro-imageGA desde el 28-05-2026Solo global1K, 2K, 4K28 de mayo de 2027 o después
Nano Banana 2 Litegemini-3.1-flash-lite-imageGA desde el 23-06-2026Solo global1K28 de junio de 2027 o después
Nano Banana (original)gemini-2.5-flash-imageObsoletoglobal y regiones de EE. UU. y Europa1K15 de marzo de 2027
Nano Banana 2 previewgemini-3.1-flash-image-previewRetirado el 17-07-2026———
Nano Banana Pro previewgemini-3-pro-image-previewRetirado el 17-07-2026———

Google aclara en la tabla de versiones de modelos de Agent Platform que estas fechas se refieren al fin del soporte en Agent Platform, no en la Gemini API.

Qué ID poner en un proyecto nuevo. gemini-nano-banana-2.1 con location="global": es la actualización de Nano Banana 2 y en 1K y 2K cuesta la mitad por imagen (el cálculo está en la sección de costes). Quédate con gemini-3.1-flash-image si necesitas us o eu, salida de 512, Flex PayGo o fijar temperature o seed, porque 2.1 no admite nada de eso. Lo mismo si tu equipo necesita un plazo de soporte garantizado: Agent Platform coloca 2.1 entre los modelos de disponibilidad más corta, sin fecha de retirada anunciada y con el compromiso de publicarla al menos 45 días antes, mientras que Nano Banana 2, Pro y Lite están en la tabla de modelos disponibles durante al menos 12 meses (Nano Banana 2, hasta el 28 de mayo de 2027 o después). Y valora gemini-3-pro-image si el texto dentro de la imagen tiene que salir literal: en la comparativa Nano Banana 2.1 vs Pro vs GPT Image 2.5: mismo prompt, 9 pruebas, con una sola tirada por prompt a 1K, Pro mantuvo la redacción pedida y 2.1 la cambió en 3 tareas de texto. Las novedades de 2.1 están en Nano Banana 2.1: novedades, precio y prueba real por API.

Tres consecuencias prácticas:

  1. Si tu equipo necesita procesar en la UE, la única opción de la familia nueva es Nano Banana 2 con location="eu": la ficha del modelo incluye eu tanto en disponibilidad como en procesamiento de ML, además de en Standard PayGo y Provisioned Throughput (añadido el 31 de agosto de 2026). Nano Banana 2.1, Nano Banana Pro y Nano Banana 2 Lite solo existen en global, así que el paso a 2.1 no es posible para ti mientras eso no cambie. El modelo original sí admite regiones europeas concretas (europe-southwest1, que es Madrid, europe-west1, europe-west4, europe-west8, europe-north1 y europe-central2), pero se retira en marzo de 2027.
  2. Una región como us-central1 no sirve para Nano Banana 2.1, Nano Banana 2 ni Pro. El ejemplo de Node.js de la propia guía de generación de imágenes usa gemini-2.5-flash-image y pone us-central1 como valor por defecto; si cambias solo el modelo, esa location deja de valer. Fija GOOGLE_CLOUD_LOCATION=global de forma explícita.
  3. El mismo ID no tiene la misma vida en las dos plataformas. gemini-3.1-flash-image está obsoleto en la Gemini API sin fecha de cierre, mientras que en Agent Platform sigue GA con soporte hasta mayo de 2027 o después. La versión preview de Nano Banana 2 se cerró en la Gemini API el 25 de junio de 2026 y en Agent Platform el 17 de julio. Y para gemini-2.5-flash-image hay dos fechas publicadas en la Gemini API.

Locations por modelo: 2.1, Pro y Lite en global; Nano Banana 2 también us y eu

En cuanto a formatos, Nano Banana 2.1, Nano Banana 2 y Pro admiten 15 relaciones de aspecto en Agent Platform, incluidas 1:4, 4:1, 1:8, 8:1, 21:9 y 9:21, y hasta 14 imágenes de referencia por prompt (7 MB por archivo en línea, 30 MB desde Cloud Storage). Los tres admiten fundamentación con la Búsqueda de Google, y la ficha de 2.1 añade la búsqueda de imágenes (Nano Banana 2 Lite no admite fundamentación). Ninguno de los modelos de Nano Banana admite ajuste fino (tuning), llamadas a funciones ni ejecución de código.

Primera llamada desde Python

Proyecto y credenciales

Necesitas un proyecto de Google Cloud con facturación activa y la API de Agent Platform habilitada (aiplatform.googleapis.com). Para autenticarte:

  • En tu máquina: gcloud auth application-default login crea las credenciales predeterminadas de la aplicación (ADC) que el SDK busca por su cuenta.
  • En producción: una cuenta de servicio con permisos sobre Agent Platform, asociada al servicio donde corre tu código (Cloud Run, GKE, una VM). No hace falta ninguna clave en el código.

Instala o actualiza el SDK con pip install --upgrade google-genai. Las rutas y mensajes que verás más abajo corresponden a la versión 2.25.0, publicada el 22 de septiembre de 2026; con versiones antiguas que no acepten enterprise, actualiza o usa vertexai=True.

Código mínimo

La forma oficial es declarar el entorno con tres variables y crear el cliente sin argumentos:

bash
export GOOGLE_CLOUD_PROJECT=tu-proyecto
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

Si prefieres que la configuración quede a la vista en el código, pasa los mismos valores al cliente:

python
from google import genai
from google.genai import types

client = genai.Client(
    enterprise=True,        # en código antiguo: vertexai=True
    project="tu-proyecto",
    location="global",      # "us" o "eu" solo con Nano Banana 2
)

response = client.models.generate_content(
    model="gemini-nano-banana-2.1",   # Nano Banana 2: "gemini-3.1-flash-image"
    contents="Cartel minimalista de una bicicleta roja sobre fondo azul claro",
    config=types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config=types.ImageConfig(aspect_ratio="16:9", image_size="2K"),
    ),
)

for i, part in enumerate(response.candidates[0].content.parts):
    if part.text:
        print(part.text)
    elif part.inline_data:
        ext = part.inline_data.mime_type.split("/")[-1]
        with open(f"imagen_{i}.{ext}", "wb") as f:
            f.write(part.inline_data.data)

Con project="tu-proyecto" y location="global", este cliente envía la petición a https://aiplatform.googleapis.com/v1beta1/projects/tu-proyecto/locations/global/publishers/google/models/gemini-nano-banana-2.1:generateContent (el SDK solo inserta el ID en la ruta, sin validarlo), y generationConfig sale serializado como {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "16:9", "imageSize": "2K"}}. Si no indicas image_size, la salida es 1K. Para Nano Banana 2 o Pro basta con cambiar el modelo a gemini-3.1-flash-image o gemini-3-pro-image; con Pro, siempre global.

Si adaptas código de Nano Banana 2 a 2.1, quita del GenerateContentConfig los parámetros temperature, top_p, top_k, seed y logprobs: la ficha de Nano Banana 2.1 en Agent Platform indica que cualquiera de ellos devuelve un error de la API. Tampoco pidas image_size="512", que 2.1 no ofrece.

La misma llamada con curl

Para descartar el SDK cuando algo falla, la petición REST directa con tu usuario de gcloud es:

bash
curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://aiplatform.googleapis.com/v1/projects/TU_PROYECTO/locations/global/publishers/google/models/gemini-nano-banana-2.1:generateContent" \
  -d '{
    "contents": {"role": "USER", "parts": [{"text": "Cartel minimalista de una bicicleta roja"}]},
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "16:9", "imageSize": "2K"}
    }
  }' > respuesta.json

La imagen llega en base64 dentro de inlineData.data. Los ejemplos REST oficiales usan v1; el SDK de Python usa v1beta1. Para Nano Banana 2, sustituye el ID por gemini-3.1-flash-image.

Modo express con clave de API

Agent Platform también tiene un modo express, todavía en versión preliminar, pensado para cuentas @gmail.com: te da una clave de API y, si eres usuario nuevo de Google Cloud, 90 días de nivel gratuito sin datos de facturación. En Python se usa genai.Client(enterprise=True, api_key="TU_CLAVE"), sin proyecto ni location; en REST, https://aiplatform.googleapis.com/v1/publishers/google/models/{modelo}:streamGenerateContent?key={TU_CLAVE}.

No lo tomes como una vía gratuita para Nano Banana 2.1, Nano Banana 2 o Pro. A 24 de septiembre de 2026, la página del modo express aún listaba como disponibles los IDs preview retirados y gemini-2.5-flash-image (10 peticiones por minuto), pero no los IDs GA de Nano Banana 2 ni Pro. Si ya usas Google Cloud o activas la facturación, el nivel gratuito desaparece.

Cuánto cuesta cada imagen

Agent Platform cobra las imágenes generadas como tokens de salida. Cada resolución consume un número fijo de tokens, así que el coste de la imagen es:

coste por imagen = tokens de la resolución × precio por millón de tokens ÷ 1.000.000

Con las tarifas de Agent Platform a 8 de octubre de 2026 (Standard PayGo, en USD): salida de imagen de Nano Banana 2.1 a 30 $ por millón, solo en global; Nano Banana 2 a 60 $ por millón en global y 66 $ fuera de global; Nano Banana Pro a 120 $; Nano Banana 2 Lite a 30 $. Batch cuesta la mitad en todos; Flex PayGo también, salvo en 2.1, que no lo admite (su precio rebajado a la mitad se aplica a Batch y Off-peak).

Modelo y opción5121K2K4K
Tokens por imagen (Nano Banana 2.1)—1.1201.6803.780
Nano Banana 2.1, Standard, global—0,0336 $0,0504 $0,1134 $
Nano Banana 2.1, Batch u Off-peak (sin Flex), global—0,0168 $0,0252 $0,0567 $
Tokens por imagen (Nano Banana 2)7471.1201.6802.520
Nano Banana 2, Standard, global0,0448 $0,0672 $0,1008 $0,1512 $
Nano Banana 2, Standard, us/eu0,0493 $0,0739 $0,1109 $0,1663 $
Nano Banana 2, Flex o Batch, global0,0224 $0,0336 $0,0504 $0,0756 $
Nano Banana Pro, Standard (1.120 tokens en 1K y 2K; 2.000 en 4K)—0,1344 $0,1344 $0,24 $
Nano Banana Pro, Flex o Batch—0,0672 $0,0672 $0,12 $
Nano Banana 2 Lite (1.120 tokens, solo 1K)—0,0336 $——

Google redondea el 4K de 2.1 a 0,113 $ en su página de precios; la tabla muestra el resultado exacto de la fórmula.

Ejemplo: 1.000 imágenes 2K de Nano Banana 2 en global salen por 1.680 × 60 × 1.000 ÷ 1.000.000 = 100,80 $ en Standard y por 50,40 $ en Batch. Las mismas imágenes en eu suben a 110,88 $ en Standard. Con Nano Banana 2.1 son 1.680 × 30 × 1.000 ÷ 1.000.000 = 50,40 $ en Standard y 25,20 $ en Batch. En 4K la diferencia se estrecha, porque 2.1 gasta 3.780 tokens por imagen frente a 2.520: 113,40 $ frente a 151,20 $ por cada 1.000 imágenes. Un detalle curioso: en 1K, 2.1 cuesta por imagen lo mismo que Nano Banana 2 Lite (0,0336 $), aunque su entrada y su razonamiento son más caros.

Estas cifras solo cubren la imagen de salida. Encima van:

  • Imágenes de referencia: 1.120 tokens de entrada cada una en Nano Banana 2 (unos 0,00056 $) y en 2.1 (unos 0,00168 $, porque su entrada cuesta 1,50 $ por millón), y 560 en Pro (unos 0,00112 $).
  • Texto y razonamiento: el prompt y los tokens de texto o de razonamiento de la respuesta se cobran a su propia tarifa: en Nano Banana 2, 0,50 $ por millón de entrada y 3 $ por millón de salida en global; en 2.1, 1,50 $ y 7,50 $. 2.1 razona por defecto a un nivel más alto que Nano Banana 2, así que esa parte pesa más en su factura.
  • Búsqueda de Google: la fundamentación se factura aparte; hay 5.000 búsquedas gratis al mes compartidas entre los modelos Gemini 3 y después 14 $ por cada 1.000.
  • Intentos bloqueados o repetidos: tómalas como estimaciones, no como factura.

La Gemini API con clave de AI Studio cobra exactamente lo mismo que la columna global, 2.1 incluido (precios de la Gemini API), así que el único diferencial de precio de lista entre plataformas es ese 10 % de us/eu en Nano Banana 2. Para el precio de Nano Banana 2 frente a 2.1 en más escenarios, mira Nano Banana 2 API: precio por imagen y cuánto ahorras con 2.1.

¿Hay alguna forma de no pagar? Pocas. El nivel gratuito de la Gemini API no incluye Nano Banana 2.1, Nano Banana 2 ni Pro; la app Gemini sí ofrece Nano Banana 2 gratis, pero eso no es la API, y 2.1 en la app exige un plan de Google AI. El crédito de bienvenida de 300 $ de la prueba gratuita de Google Cloud (90 días) excluye de forma expresa los costes de la Gemini API en AI Studio, pero no menciona los modelos Gemini propios de Agent Platform, por lo que en principio cubre estas llamadas (funciones gratuitas de Google Cloud).

Si no necesitas nada propio de Vertex (residencia de datos, CMEK, VPC-SC, SLA de Google) y lo que te frena es abrir facturación en Google Cloud, existen pasarelas de terceros con tarifa plana por llamada. Por ejemplo, laozhang.ai sirve gemini-nano-banana-2.1 a 0,045 $, gemini-3.1-flash-image a 0,055 $, gemini-3-pro-image a 0,09 $ y gemini-3.1-flash-lite-image a 0,025 $ por llamada, sin variar con la resolución (tarifas publicadas a 8 de octubre de 2026), con formato nativo generateContent y imageConfig. Con 2.1, Google directo sale más barato en 1K y 2K; la tarifa plana solo compensa en 4K. No es Vertex AI: esas llamadas no pasan por tu proyecto de Google Cloud ni heredan sus controles.

Aviso: laozhang.ai es un servicio propio. Sus precios son nuestra tarifa, no una comparación independiente.

Diagnóstico: dónde falla la llamada y cómo arreglarlo

Los mensajes de error citados abajo salen de construir clientes con google-genai 2.25.0 sin conexión: ninguna petición llegó a Google ni se generó ninguna imagen. Valen para los fallos locales del SDK; los rechazos del servidor se reconocen por su causa, no por un texto concreto.

Diagnóstico de errores en tres fases: al crear el cliente, rechazo del servidor y error 429, con síntoma, causa y solución de cada caso

Falla al crear el cliente, antes de enviar nada

MensajeCausaSolución
ValueError: Gemini API does not support project/location.Pasaste project y location sin enterprise=True, y el SDK creyó que querías la Gemini APIAñade enterprise=True o exporta GOOGLE_GENAI_USE_ENTERPRISE=True
ValueError: enterprise and vertexai flags have conflicting values, please set enterprise value only.Mezclaste enterprise=True con vertexai=FalseDeja solo enterprise=True
ValueError: No API key was provided...No hay clave ni indicador de empresa: el SDK intenta la Gemini APIConfigura las tres variables de entorno o pasa enterprise=True con proyecto y location
DefaultCredentialsError: Your default credentials were not found...enterprise=True sin credenciales ADC en la máquinagcloud auth application-default login en local; cuenta de servicio en producción

Con versiones antiguas del SDK, el equivalente al primer error era Missing key inputs argument! ... provide (vertexai, project & location) arguments., un mensaje que aún aparece en foros de 2025.

Otro caso que no da error pero confunde: si defines a la vez GOOGLE_GENAI_USE_ENTERPRISE=True y GOOGLE_GENAI_USE_VERTEXAI=False, gana la primera. El SDK imprime un aviso y sigue enviando a Agent Platform, así que poner GOOGLE_GENAI_USE_VERTEXAI=False ya no basta para volver a la Gemini API.

La petición sale, pero el servidor la rechaza

  • ID preview. El SDK no valida el nombre del modelo: con gemini-3.1-flash-image-preview construye la URL .../models/gemini-3.1-flash-image-preview:generateContent igual que con el ID bueno, y el rechazo solo llega desde el servidor. Si tu código viene de un tutorial de 2025, busca -preview y cámbialo por un ID GA de la tabla de modelos: gemini-nano-banana-2.1 (o gemini-3.1-flash-image si necesitas us/eu) en lugar del preview de Nano Banana 2, y gemini-3-pro-image en lugar del de Pro.
  • Parámetros de muestreo con 2.1. Si pasas temperature, top_p, top_k, seed o logprobs a gemini-nano-banana-2.1, la API devuelve un error. Es lo primero que revisar cuando un código que funcionaba con Nano Banana 2 falla al cambiar solo el ID.
  • Location equivocada. Nano Banana 2.1 o Nano Banana Pro con us, eu o us-central1, o Nano Banana 2 con una región concreta: ninguno de esos modelos está publicado ahí. Con global se elimina la duda.
  • Código de ai.google.dev. La documentación de la Gemini API presenta ahora Nano Banana con la Interactions API (response_format con aspect_ratio e image_size), mientras que la de Agent Platform usa generate_content con image_config; la ficha de 2.1 en Agent Platform marca la Interactions API como no admitida. Mezclar los dos ejemplos es una fuente probable de peticiones que no encajan; con un cliente de Vertex, quédate con generate_content. A la inversa, los campos output_mime_type, output_compression_quality, prominent_people e image_output_options de ImageConfig solo existen en Agent Platform.
  • Pasarelas propias. Si llamas a través de un proxy o gateway autoalojado, comprueba que su versión admite estos modelos y respuestas con la imagen en base64 dentro de inlineData. En 2025 hubo pasarelas de código abierto que necesitaron una actualización para que la llamada que funcionaba en la consola funcionara también a través de ellas.

Si lo que ves es que nada responde, ni siquiera con el código que ayer funcionaba, antes de tocar la configuración consulta ¿Nano Banana 2 está caído? Comprueba el estado correcto.

429 «Resource exhausted»

En Standard PayGo el 429 llega con el mensaje Resource exhausted, please try again later.; con Provisioned Throughput, Too many requests. Exceeded the Provisioned Throughput. (errores 429 de Agent Platform). Con los modelos de imagen no hay un número al que agarrarse. Las fichas de los modelos de Nano Banana, 2.1 incluido, marcan la cuota fija como no disponible, así que no existe una cuota por proyecto que puedas pedir que te amplíen. Y la página de Standard PayGo aclara que sus niveles de rendimiento por gasto no se aplican a Gemini 3.1 Flash Image, 3.1 Flash-Lite Image, 3 Pro Image ni 2.5 Flash Image: gastar más no te sube de nivel con estos modelos. La capacidad en Standard PayGo es compartida y se sirve «en la medida de lo posible», sin una cifra publicada de imágenes ni de tokens por minuto.

Lo que sí puedes hacer para reducir los 429:

  1. Usa el endpoint global en lugar de uno regional; Google lo recomienda porque reparte las peticiones entre más capacidad.

  2. Reintenta con retroceso exponencial. El SDK google-genai 2.25.0 no reintenta por defecto; si pasas HttpRetryOptions, reintenta ante 408, 429, 500, 502, 503 y 504 (con los valores por defecto: 5 intentos en total, esperas de 1, 2, 4 y 8 segundos aproximadamente, con un máximo de 60):

    python
    client = genai.Client(
        enterprise=True,
        project="tu-proyecto",
        location="global",
        http_options=types.HttpOptions(retry_options=types.HttpRetryOptions()),
    )
  3. Reparte las peticiones a lo largo del minuto: Google advierte de que los picos de pocos segundos provocan limitación aunque la media sea baja.

  4. Si necesitas capacidad garantizada, contrata Provisioned Throughput; los 429 de Standard PayGo no cuentan para el SLA.

Hay un antecedente conocido: el 2 de enero de 2026 un usuario abrió un hilo en el foro de desarrolladores de Google describiendo 429 constantes con Nano Banana Pro en Vertex pese a un uso muy escaso; el personal de Google dijo haber desplegado una corrección el 8 de enero, y entre febrero y marzo llegaron más quejas (hilo del foro). Todo aquello ocurrió con los modelos preview, así que no dice nada de la fiabilidad actual en ningún sentido. Para las cuotas de la Gemini API con clave de AI Studio, mira Límites de Nano Banana 2: cuota en Gemini, AI Mode y la API.

Preguntas frecuentes

¿Tengo que migrar de Nano Banana 2 a Nano Banana 2.1 en Vertex AI?

No es urgente. En Agent Platform, gemini-3.1-flash-image sigue siendo GA con soporte hasta el 28 de mayo de 2027 o después; el aviso de obsolescencia sin fecha afecta a la Gemini API con clave de AI Studio. Los proyectos nuevos sí deberían empezar con gemini-nano-banana-2.1, que cuesta la mitad por imagen en 1K y 2K. Para migrar, cambia el ID, quita temperature, top_p, top_k, seed y logprobs, y sigue en Nano Banana 2 si dependes de us/eu, de la salida de 512, de Flex PayGo o de un plazo de soporte garantizado: 2.1 no tiene fecha de retirada, pero Google solo se compromete a avisar con 45 días.

¿Las imágenes generadas con Vertex AI llevan marca de agua?

No llevan un logotipo visible, pero sí marcas invisibles: la documentación de Gemini indica que todas las imágenes generadas incluyen una marca SynthID, y las fichas de Nano Banana 2.1, Nano Banana 2 y Pro en Agent Platform declaran compatibilidad con Content Credentials (C2PA). Afirmar que «en Vertex no hay marca de agua» solo es cierto si hablas de la marca visible.

¿Se puede hacer ajuste fino de Nano Banana en Vertex AI?

No. Las fichas de Nano Banana 2.1, Nano Banana 2, Nano Banana Pro y Nano Banana 2 Lite marcan el ajuste (tuning) como no disponible. Para adaptar el estilo quedan el prompt, las instrucciones del sistema y las imágenes de referencia (hasta 14 por petición).

¿Puedo generar con Nano Banana Pro desde una región europea?

No. Nano Banana Pro solo está disponible en global, igual que Nano Banana 2.1. Si necesitas que el procesamiento ocurra en la UE, tu opción es Nano Banana 2 con location="eu", un 10 % más cara que en global. Cómo montar la petición de Pro está en API de Nano Banana Pro: petición JSON, YAML y guardado de imágenes.

¿Tengo que reescribir mi código si ya usaba vertexai=True?

No necesariamente. vertexai=True sigue llevando al mismo endpoint que enterprise=True en la versión 2.25.0 del SDK. Lo que sí debes cambiar son los IDs -preview y, si lo tenías, un location regional como us-central1 en llamadas a Nano Banana 2.1, Nano Banana 2 o Pro.

Fuentes13

Páginas externas que cita esta guía, en el orden en que aparecen. Última actualización: 8 oct 2026.

  1. 1.notas de la versióndocs.cloud.google.com/gemini-enterprise-agent-platform/release-notes
  2. 2.Gemini API: migrar a Google Cloudai.google.dev/gemini-api/docs/migrate-to-cloud
  3. 3.tabla de retiradas de la Gemini APIai.google.dev/gemini-api/docs/deprecations
  4. 4.página de precios de la Gemini APIai.google.dev/gemini-api/docs/pricing
  5. 5.tabla de versiones de modelos de Agent Platformdocs.cloud.google.com/vertex-ai/generative-ai/docs/learn/model-versions
  6. 6.guía de generación de imágenesdocs.cloud.google.com/vertex-ai/generative-ai/docs/multimodal/image-generation
  7. 7.ficha de Nano Banana 2.1 en Agent Platformdocs.cloud.google.com/vertex-ai/generative-ai/docs/models/gemini/nano-banana-2-1
  8. 8.página del modo expressdocs.cloud.google.com/vertex-ai/generative-ai/docs/start/express-mode/overview
  9. 9.tarifas de Agent Platformcloud.google.com/vertex-ai/generative-ai/pricing
  10. 10.funciones gratuitas de Google Clouddocs.cloud.google.com/free/docs/free-cloud-features
  11. 11.errores 429 de Agent Platformdocs.cloud.google.com/vertex-ai/generative-ai/docs/provisioned-throughput/error-code-429
  12. 12.Standard PayGodocs.cloud.google.com/vertex-ai/generative-ai/docs/dynamic-shared-quota
  13. 13.hilo del forodiscuss.ai.google.dev/t/nano-banana-pro-vertex-ai-api-unreliable/113884