¿Qué novedades trae la API de Nano Banana 2 en Emix.ai?

`nano-banana-2` admite prompts de hasta 20.000 caracteres, hasta 14 imágenes de referencia (30 MB en total para JPEG/PNG/WebP), 14 relaciones de aspecto además de `auto`, y tres niveles de resolución (`1K`, `2K`, `4K`) con salida en PNG o JPG — todo a través de `POST https://api.emix.ai/api/v1/client/tasks`.

¿En qué se diferencia Nano Banana 2 del Nano Banana anterior?

El ID del modelo anterior era `nano-banana`; el nuevo ID es `nano-banana-2`. Nano Banana 2 aumenta el límite del prompt a 20 000 caracteres, admite hasta 14 imágenes de referencia, ofrece 14 relaciones de aspecto (incluyendo `8:1`, `4:1` y `21:9`) y añade la resolución `4K`. Consulta la tabla de parámetros de arriba y la referencia completa en docs.emix.ai/market/google/nanobanana2.

¿Cuántas imágenes de referencia puedo enviar en una sola llamada?

Hasta 14 imágenes a través de `input.image_input`, con un tamaño total de 30 MB. Los formatos aceptados son JPEG, PNG y WebP.

¿Nano Banana 2 soporta audio o sincronización labial?

No. Nano Banana 2 es un modelo de generación de imágenes (de texto a imagen y edición de imágenes basada en referencias). No produce salidas de audio ni video.

¿Qué resoluciones y relaciones de aspecto están disponibles?

`input.resolution` acepta `1K`, `2K` o `4K` (`1K` por defecto). `input.aspect_ratio` acepta `1:1`, `1:4`, `1:8`, `2:3`, `3:2`, `3:4`, `4:1`, `4:3`, `4:5`, `5:4`, `8:1`, `9:16`, `16:9`, `21:9` o `auto` (por defecto).

¿Qué formatos de salida devuelve la API?

`png` o `jpg`, configurado a través de `input.output_format` (por defecto `jpg`).

¿Dónde puedo probar gratis Nano Banana 2 antes de integrarlo?

Usa la demo en el navegador en emix.ai/models/nano-banana-2, y luego el Playground con todos los parámetros en emix.ai/playground/nano-banana-2. Cada campo del Playground se asigna directamente a un parámetro de la API.

¿Cómo integro la API en mi aplicación?

Envía una solicitud `POST` a `https://api.emix.ai/api/v1/client/tasks` con `Authorization: Bearer YOUR_API_KEY` y un cuerpo JSON que contenga `model: "nano-banana-2"` y tu objeto `input`. La API devuelve `data.taskId`; consulta periódicamente el endpoint Get Task Details o configura `callBackUrl` para recibir el resultado mediante un webhook. Encontrarás ejemplos ejecutables de cURL, Python y Node.js en la Sección 5.

Nano Banana 2 se factura del saldo de créditos de tu cuenta de Emix.ai; una respuesta de `402 insufficient credits` significa que es momento de recargar. Las tarifas de créditos actuales están publicadas en la página de precios de Emix.ai (emix.ai/pricing) y en docs.emix.ai/market/google/nanobanana2.

¿Qué códigos de estado debo manejar?

`200` éxito, `401` no autorizado, `402` créditos insuficientes, `404` no encontrado, `422` error de validación, `429` límite de tasa, `433` límite de sub-clave, `455` servicio no disponible, `500` error del servidor, `501` generación fallida, `505` función deshabilitada.

¿La tarea es síncrona?

No. La solicitud devuelve un `taskId` inmediatamente. Recupera la imagen terminada desde el endpoint unificado Get Task Details o recíbela en tu webhook a través de `callBackUrl`.

README.md

API Nano Banana 2: Genera imágenes 4K con hasta 14 referencias en Emix.ai

Ejecuta la API Nano Banana 2 (Gemini 3.1 Flash Image) de Google en Emix.ai para transformar un prompt —y hasta 14 imágenes de referencia— en imágenes PNG o JPG nítidas a 1K, 2K o 4K. Un endpoint, una clave Bearer, un taskId asíncrono. Pruébalo gratis en el Playground y luego implementa la misma llamada en producción. Ya disponible en Emix.ai. POST https://api.emix.ai/api/v1/client/tasks con el modelo: "nano-banana-2". Referencia completa: docs.emix.ai/market/google/nanobanana2.

Pruébalo en el Playground Ver la documentación

Lanzamiento y disponibilidad de la API

La API de Nano Banana 2 ya está disponible en Emix.ai. Nano Banana 2 es el último modelo de texto a imagen y edición de imágenes de Google, lanzado como Gemini 3.1 Flash Image. El ID del modelo nano-banana-2 se puede invocar desde el endpoint de tareas unificado de Emix.ai, con la misma autenticación Bearer, el mismo patrón de tareas asíncronas y el mismo flujo de sondeo "Get Task Details" que el resto del catálogo de Emix.ai: sin SDK separados ni listas de espera.Si ya tienes una clave de Emix.ai, puedes llamar a nano-banana-2 hoy mismo, sin necesidad de modificar tu integración.

Proveedor e ID del modelo

Proveedor: Google. ID del modelo: nano-banana-2.

Endpoint y autenticación

Endpoint: POST https://api.emix.ai/api/v1/client/tasks. Autenticación: Authorization: Bearer YOUR_API_KEY.

Procesamiento

Asíncrono: la solicitud devuelve un taskId, los resultados se obtienen del endpoint Get Task Details o se envían a tu webhook callBackUrl.

Documentación

docs.emix.ai/market/google/nanobanana2

Playground

emix.ai/playground/nano-banana-2

Disponibilidad

Ya disponible en Emix.ai. Las claves de API existentes de Emix.ai pueden llamar a nano-banana-2 hoy mismo sin necesidad de modificar la integración.

Características clave de la API de Nano Banana 2

La API de Nano Banana 2 en Emix.ai expone toda la superficie de generación de imágenes del modelo a través de un solo POST. Cada parámetro a continuación es validado por la API en vivo.

De texto a imagen, con edición de referencia opcional

Envía input.prompt por sí solo para la generación pura de texto a imagen, o adjunta hasta 14 imágenes de referencia a través de input.image_input para edición, transferencia de estilo, consistencia de personajes o composición de múltiples referencias. El tamaño total de las referencias combinadas puede sumar hasta 30 MB en archivos JPEG, PNG o WebP.

Prompts extensos y expresivos

input.prompt acepta hasta 20.000 caracteres: espacio suficiente para descripciones detalladas de escenas, pautas de marca o listas de tomas sin recortes.

14 relaciones de aspecto + auto

Elige entre 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 o auto (predeterminado). Las publicaciones cuadradas, los reels verticales, los banners ultraanchos y las tiras panorámicas tienen soporte nativo.

Tres niveles de resolución

input.resolution ofrece 1K, 2K o 4K (1K predeterminado). Elige 4K para impresiones, imágenes principales y fotografía de productos; o 1K para miniaturas e iteraciones rápidas.

Salida en formato PNG o JPG

input.output_format es png o jpg (jpg por defecto). PNG para flujos de trabajo sensibles a la transparencia y revisión sin pérdidas, JPG para entregables más ligeros.

Asíncrono por diseño con webhooks

Envía la tarea, obtén un taskId al instante y haz polling en el endpoint Get Task Details o configura callBackUrl para que Emix.ai envíe la tarea completada a tu servidor mediante un POST.

Códigos de error predecibles

401 no autorizado, 402 créditos insuficientes, 422 validación, 429 límite de peticiones, 433 límite de subclave, 455 servicio no disponible, 500 error de servidor, 501 error de generación, 505 función deshabilitada: fáciles de mapear a tu lógica de reintentos.

Por qué elegir Emix.ai para la API de Nano Banana 2

Una clave, un endpoint, todos los modelos

La misma ruta https://api.emix.ai/api/v1/client/tasks ejecuta Nano Banana 2 y el resto del catálogo de Emix.ai. Cambia de modelo modificando un solo string.

Tareas asíncronas + webhooks integrados

callBackUrl es un campo de primer nivel. Sin código de integración, sin colas personalizadas.

Playground gratuito para iterar prompts

Ajusta prompts, relación de aspecto, resolución y referencias en emix.ai/playground/nano-banana-2 antes de escribir una sola línea de código: exactamente los mismos parámetros se envían a la API.

Documentación transparente

Cada parámetro, cada código de estado, cada límite está publicado en docs.emix.ai/market/google/nanobanana2.

Facturación basada en créditos

El saldo de créditos de una sola cuenta cubre Nano Banana 2 junto con todos los demás modelos, sin contratos por modelo.

API de Nano Banana 2 frente a la generación anterior

El Nano Banana anterior en Emix.ai estableció el flujo de trabajo con múltiples referencias. Nano Banana 2 amplía la superficie de parámetros que la API acepta actualmente. La actualización es un cambio de una sola línea: sustituye "model": "nano-banana" por "model": "nano-banana-2" y podrás usar de inmediato una ventana de prompts más grande, un conjunto más amplio de relaciones de aspecto, salida en 4K y hasta 14 imágenes de referencia.

Inicio rápido

Cuatro pasos desde la idea hasta la primera llamada en producción.

Paso 1 — Prueba en línea

Abre la página del modelo en emix.ai/models/nano-banana-2 y ejecuta una generación rápida directamente en el navegador. No se requiere clave de API para la demostración.

Paso 2 — Playground

Dirígete al Playground de Nano Banana 2 (emix.ai/playground/nano-banana-2) para iterar en tu prompt, aspect_ratio, resolution, output_format y las imágenes de referencia en paralelo. Cada control en el Playground corresponde 1:1 al campo de la API con el mismo nombre.

Paso 3 — Obtén acceso a la API

Crea o inicia sesión en tu cuenta de Emix.ai, genera una clave de API desde el panel de control y confirma tu saldo de créditos. La misma clave funciona para todos los modelos del catálogo de Emix.ai.

Paso 4 — Envía tu primera solicitud

Envía una tarea con nano-banana-2. La API devuelve un taskId; haz polling en el endpoint Get Task Details o espera el webhook callBackUrl.cURL:bash

curl -X POST https://api.emix.ai/api/v1/client/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "callBackUrl": "https://your-domain.com/api/callback",
    "input": {
      "prompt": "Comic poster: cool banana hero in shades leaps from a sci-fi launch pad",
      "image_input": [],
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "output_format": "png"
    }
  }'

Python:python

import requests

resp = requests.post(
    "https://api.emix.ai/api/v1/client/tasks",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "nano-banana-2",
        "callBackUrl": "https://your-domain.com/api/callback",
        "input": {
            "prompt": "Editorial product shot of a ceramic mug on stone, soft window light",
            "image_input": [],
            "aspect_ratio": "4:5",
            "resolution": "4K",
            "output_format": "jpg",
        },
    },
)

task_id = resp.json()["data"]["taskId"]
print("taskId:", task_id)

Node.js:js

const res = await fetch("https://api.emix.ai/api/v1/client/tasks", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "nano-banana-2",
    callBackUrl: "https://your-domain.com/api/callback",
    input: {
      prompt: "Isometric icon set, 8 items, pastel palette, soft shadows",
      image_input: [],
      aspect_ratio: "1:1",
      resolution: "1K",
      output_format: "png",
    },
  }),
});

const { data } = await res.json();
console.log("taskId:", data.taskId);

Un envío exitoso devuelve:json{ "code": 200, "msg": "success", "data": { "taskId": "string" } }Utiliza el taskId con el endpoint unificado Get Task Details para recuperar la imagen terminada.

¿Qué puedes crear con la API de Nano Banana 2?

Arte de campaña coherente con la marca

Pasa un logotipo, una foto de un modelo y una referencia de color (hasta 14 imágenes en total, 30 MB) y pide a Nano Banana 2 que componga pósteres fieles a tu marca en 4K.

Fotografía de producto a gran escala

Usa 4:5 o 1:1 en 2K–4K para fichas de producto en catálogos y marketplaces; cambia output_format a png si necesitas un entregable final limpio y sin canal alfa para la revisión de diseño.

Contenido creativo vertical de formato corto

9:16 en 1K o 2K para reels, shorts y stories, generados de forma asíncrona y entregados vía callBackUrl.

Banners hero ultra anchos y panorámicas

21:9, 8:1 y 4:1 para imágenes hero de landing pages, banners publicitarios y fotogramas cinematográficos.

Consistencia de personajes y estilos basada en referencias

Hasta 14 referencias te permiten fijar un personaje, un entorno y una referencia de iluminación en una sola llamada.

Ilustración editorial y cómics

La capacidad de 20.000 caracteres para el prompt es lo suficientemente amplia para guiones de viñetas detallados y notas de encuadre.

Pipelines de assets masivos

Encola miles de tareas; deja que el webhook callBackUrl notifique a tu worker de almacenamiento en el momento en que cada imagen esté lista.

API de Nano Banana 2

4.9/ 5

128 ratings

Tap a star to rate