Migrar de Nano Banana 2 a 2.1: qué hay que cambiar en la API

Nano Banana 2.1 sigue usando la interfaz de tareas asíncronas de HiAPI, así que el volumen de cambios en el código es reducido, pero hay varias restricciones de entrada que deben revisarse de nuevo. El cambio más evidente es el valor de model; también han cambiado el número de imágenes de referencia y el tamaño de archivo por imagen. Los precios deben tomarse de la página en tiempo real y de los registros de tareas antes del lanzamiento.

Este artículo se basa en el contrato de interfaz que muestran actualmente la página del modelo Nano Banana 2 y la página del modelo Nano Banana 2.1. Los ejemplos usan la estructura de solicitud de la documentación actual; antes de cambiar el tráfico de producción, deben validarse en una cuenta de prueba con saldo.

El cambio mínimo es sustituir model

Ambas versiones se crean mediante tareas asíncronas:

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "input": {
      "prompt": "A clean e-commerce product photograph of a minimalist amber glass skincare serum bottle with a black dropper cap, blank unlabeled bottle, centered on a white marble pedestal, soft studio lighting, warm white background, no lettering",
      "resolution": "1K",
      "aspect_ratio": "1:1",
      "output_format": "png"
    }
  }'

Si la solicitud original era de texto a imagen, el punto clave de la migración es modificar model:

- "model": "nano-banana-2"
+ "model": "gemini-nano-banana-2.1"

La interfaz de la documentación sigue siendo POST /v1/tasks. Una vez aceptada la solicitud, la interfaz de creación devuelve un ID de tarea que se usa para el sondeo o el manejo de callback. El flujo existente de sondeo o callback puede seguir usándose, pero aún hay que revisar los campos actuales de estado y resultado de la tarea.

Campos que se pueden conservar y límites que deben revisarse de nuevo

El contrato actual de 2.1 conserva los campos de entrada habituales de la versión 2: prompt, el opcional image_input, aspect_ratio, resolution y output_format. La siguiente prueba de humo con saldo ya ha aceptado tanto texto a imagen como imagen de referencia; al hacer el cambio definitivo, hay que seguir revisando el contrato en tiempo real a medida que cambie la versión.

Los límites de las imágenes de referencia han cambiado. La página de Nano Banana 2 indica un máximo de 14 imágenes y 10 MB por imagen; la página de 2.1 indica un máximo de 10 imágenes y 30 MB por imagen. Sustituir solo el ID del modelo y seguir reenviando las 14 imágenes antiguas hará que la solicitud supere el límite de la nueva versión. El cliente debe comprobar la cantidad según el nuevo límite y decidir si truncar o avisar directamente al usuario.

La página del modelo 2.1 no expone la entrada mask. Durante la migración no hay que añadir el campo mask por cuenta propia, salvo que la documentación posterior de la interfaz lo indique explícitamente. Para editar imágenes, se pasa la imagen original con image_input y luego se especifica en prompt qué se quiere modificar y qué detalles deben conservarse.

{
  "model": "gemini-nano-banana-2.1",
  "input": {
    "prompt": "Keep the amber glass serum bottle and black dropper cap from the reference image. Place it on a sunlit wooden bathroom counter beside a folded cream linen towel and eucalyptus, preserving the bottle shape and blank label.",
    "image_input": ["https://static.hiapi.ai/blog/gemini-nano-banana-2-1-ecommerce-product-images/studio.jpg"],
    "resolution": "1K",
    "aspect_ratio": "16:9",
    "output_format": "png"
  }
}

Esta solicitud se completó correctamente en la prueba de humo con saldo; la imagen resultante puede verse aquí. La página de 2.1 indica actualmente que las imágenes de referencia admiten JPEG, PNG y WebP, con un máximo de 30 MB por imagen.

El precio debe verificarse en dos niveles

A fecha de la revisión de la página del modelo el 2026-10-16, los niveles 1K, 2K y 4K de Nano Banana 2.1 muestran 44, 72 y 116 créditos respectivamente. Antes de planificar el presupuesto, consulte la página de precios en tiempo real y la página del modelo; la lectura del cargo sigue pendiente de verificación independiente.

No hay que escribir los precios promocionales ni las cifras de la página de una cuenta concreta como precio fijo a largo plazo. Al validar el lanzamiento, registre la resolución, el importe mostrado antes del envío y el cargo real tras completarse la tarea.

Cambiar dos model ID con el mismo prompt

Para comprobar la ruta de migración, enviamos el mismo prompt de 1K y 1:1 usando los dos model ID públicos. Ambas solicitudes crearon la tarea correctamente y alcanzaron success. Los detalles de la botella y la superficie difieren entre las dos imágenes, así que este conjunto de resultados sirve para verificar el enrutamiento y el procesamiento de resultados, pero no basta para clasificar la calidad de imagen ni demuestra que la identidad del producto sea la misma.

Prompt usado en las dos solicitudes:

A clean e-commerce product photograph of a minimalist amber glass skincare serum bottle with a black dropper cap, blank unlabeled bottle, centered on a white marble pedestal, soft studio lighting, warm white background, no lettering

Ruta	Model ID	Resultado
Nano Banana 2	nano-banana-2	1K, 1:1, PNG, tarea completada correctamente
Nano Banana 2.1	gemini-nano-banana-2.1	1K, 1:1, PNG, tarea completada correctamente

Esta validación de la migración demuestra que el model ID de 2.1 acepta la estructura de tarea de texto a imagen de la documentación actual y devuelve la imagen mediante el mismo flujo asíncrono. Las diferencias visuales de un único conjunto de muestras solo deben tomarse como observación, no como resultado de una comparativa de modelos.

Lista de comprobación antes del lanzamiento

1. Sustituya nano-banana-2 por el ID exacto de la nueva versión: gemini-nano-banana-2.1.
2. Conserve el flujo asíncrono POST /v1/tasks y el manejo actual del estado de las tareas.
3. Valide que image_input sea un arreglo de URL públicas de imágenes, con un máximo de 10.
4. Cambie la suposición antigua de 10 MB por imagen por el límite de 30 MB que indica actualmente la página de 2.1.
5. Conserve prompt, aspect_ratio, resolution y output_format, y elimine los campos sin respaldo en la documentación, como mask.
6. En la cuenta de prueba, envíe una tarea de solo texto y una tarea de edición con imagen de referencia, y guarde la solicitud, el ID de tarea, el estado final, la URL del resultado y el importe del cargo.
7. Compare una vez los resultados y el manejo de errores con la versión anterior y, después, cambie el modelo predeterminado para todos los usuarios.

Lectura del precio y mantenimiento posterior

La prueba de humo anterior ya ha validado la estructura de solicitud de texto a imagen e imagen a imagen, la creación de tareas, el éxito en el estado final y la URL del resultado. El cargo no se ha leído de forma independiente a partir de la tarea completada; el costo de producción debe seguir basándose en la página de precios en tiempo real y en los registros de tareas. Si el contrato o los límites de la página del modelo cambian antes del lanzamiento, también hay que revisarlos de nuevo.

Preguntas frecuentes

¿Hay que cambiar la interfaz para migrar a Nano Banana 2.1?

Actualmente, las dos páginas de modelo usan POST /v1/tasks. Primero modifique el ID del modelo y luego valide la entrada y la estructura de retorno con solicitudes reales.

¿Todavía se puede usar nano-banana-2?

Ese ID sigue representando a Nano Banana 2. Cuando se necesite llamar a 2.1, debe usarse gemini-nano-banana-2.1.

¿Se pueden seguir enviando 14 imágenes de referencia tras la migración?

La página del modelo 2.1 indica actualmente un límite de 10. Si se supera la cantidad, el cliente debe reducirla o rechazar la solicitud.

¿La edición con imágenes de referencia requiere otra interfaz?

La página actual no tiene una interfaz de edición separada. Siga usando el mismo model ID, añada image_input y especifique en el prompt qué hay que cambiar y qué detalles deben conservarse.

¿Es 2.1 más barato para todas las cuentas?

La página pública muestra actualmente cifras estándar de créditos más bajas para cada resolución, pero los precios pueden ajustarse y la página también puede verse afectada por el estado de la cuenta o de las promociones. Antes de sacar conclusiones de costos, verifique a la vez el precio en tiempo real y el registro del cargo tras completar la tarea.

Lectura adicional

• Tutorial de integración de la API de Nano Banana 2.1
• Precios de la API de Nano Banana 2.1
• Cómo usar la API de Nano Banana 2

Pruebe Nano Banana 2.1 en la página del modelo de HiAPI.