Nano Banana

API de edición de imágenes Nano Banana en E2X: tres referencias y una fecha de apagado

La capability de edición de Nano Banana es el gemini-2.5-flash-image de Google recibiendo imágenes de origen en lugar de un lienzo en blanco. Lo servimos en google/nano-banana/edit-image por $0.0312 por imagen editada —un 20% por debajo de fal.ai— y acepta un máximo de tres imágenes de referencia con salida 1K. Antes de que escriba una sola línea de código de integración, hay algo que va primero: Google retira este modelo el 2 de octubre de 2026.

Treinta y siete días, contados desde el día en que publicamos esta página. Los pipelines existentes siguen funcionando hasta entonces y nuestro precio no se mueve. Pero venderle un editor con un reloj de cinco semanas encima solo le compraría una reescritura en octubre.

Nuestro precio frente al mercado, comprobado el 26 de agosto de 2026:

Los precios y las condiciones de los productos pueden cambiar con el tiempo; consulte los precios vigentes de cada proveedor antes de tomar una decisión de compra. Los precios de Google Batch o Flex no son directamente equivalentes a un request estándar de API bajo demanda, porque la programación, la disponibilidad y las condiciones de procesamiento son distintas; por eso quedan excluidos de esta comparación. Se trata de una comparación acotada, no de una afirmación de que E2X sea la opción más barata del mundo en cualquier configuración.

Por qué abrimos con un aviso de retirada

Porque Google hace lo mismo. Cuando la compañía anunció Nano Banana 2 Lite, escribió:

"Es nuestro reemplazo recomendado para los desarrolladores que hoy usan nuestra primera versión de Nano Banana (gemini-2.5-flash-image); puede cambiarlo ya mismo y obtener beneficios inmediatos."

La documentación de modelos de Google va más lejos: llama a este el pionero heredado de la serie y recomienda encarecidamente que los clientes hagan la transición. Rara vez un proveedor empuja a sus clientes fuera de un producto que todavía factura. Cuando lo hace, créale.

¿No tiene una imagen de origen sobre la que trabajar? Entonces lo que quiere es Nano Banana text-to-image: mismo modelo, mismo precio, solo prompt.

El techo de tres referencias

Este es el número que separa al editor heredado de todo lo más nuevo de la familia. La guía de Google es explícita: para obtener los mejores resultados con Gemini 2.5 Flash Image, incluya un máximo de tres imágenes en una entrada.

Tres alcanzan para mucho trabajo real. Un sujeto, una placa de fondo, una referencia de color: ese compuesto cabe. Lo que no cabe es el brief estilo publicitario donde un personaje, un producto, el atrezo y una paleta de marca aterrizan en una sola llamada. Nano Banana Pro acepta catorce referencias justamente para ese trabajo. Aquí, en cambio, encadena llamadas, paga cada salto, y cada salto se aleja un poco más de su original.

Dos límites más que conviene tener delante antes de diseñar alrededor de este modelo:

• La salida se topa en 1K. En esta generación no existe un nivel mayor, sugiera lo que sugiera un campo del schema.
• No le pida que arregle texto dentro de una imagen. El renderizado de texto dentro de la imagen es una fortaleza de Gemini 3, no de este modelo. Reemplazar un precio en una etiqueta o traducir un cartel es el caso de fallo con el que la gente choca más a menudo.
• Hay diez aspect ratios disponibles, de 21:9 hasta 4:5, y la imagen de origen no le obliga a quedarse con el suyo.
• El presupuesto de tokens es de 65.536 de entrada y 32.768 de salida, con un knowledge cutoff de junio de 2025: por eso las referencias de cualquier cosa reciente son más seguras que las descripciones de ella.

Request de API: editar contra imágenes de origen

Dos campos son obligatorios: prompt e image_urls. Mantenga su key del lado del servidor.

curl -X POST https://api.e2x.ai/v1/jobs/submit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana/edit-image",
    "input": {
      "prompt": "Cambia la pared detrás de la silla de blanco a verde oliva oscuro. Mantén la silla, el suelo y las sombras exactamente como están.",
      "image_urls": [
        "https://example.com/interior.jpg"
      ],
      "aspect_ratio": "4:5"
    }
  }'

Al enviarlo recibe un job ID. Haga polling hasta que se resuelva:

const headers = {
  Authorization: `Bearer ${process.env.E2X_API_KEY}`,
  "Content-Type": "application/json",
};

const submitted = await fetch("https://api.e2x.ai/v1/jobs/submit", {
  method: "POST",
  headers,
  body: JSON.stringify({
    model: "google/nano-banana/edit-image",
    input: {
      prompt: "La imagen 1 es la bicicleta, la imagen 2 es la localización. Coloca la bicicleta sobre los adoquines de la imagen 2, ajustándola a su luz nublada.",
      image_urls: [
        "https://example.com/bike.jpg",
        "https://example.com/street.jpg",
      ],
      aspect_ratio: "1:1",
    },
  }),
}).then((r) => r.json());

const jobId = submitted.data.jobId;

while (true) {
  const job = await fetch(`https://api.e2x.ai/v1/jobs/${jobId}`, { headers })
    .then((r) => r.json());

  if (job.data.status === "completed") {
    console.log(job.data.outputs[0].url);
    break;
  }
  if (job.data.status === "failed") {
    throw new Error(job.data.error?.message || "Edit failed");
  }
  await new Promise((r) => setTimeout(r, 2000));
}

Los status van pending → processing → completed, con failed y cancelled como estados terminales. Pase un webhookUrl para saltarse el polling por completo. Nuestro aspect_ratio por defecto es 9:16: fíjelo, o su origen apaisado volverá en vertical. El schema en vivo está en la especificación legible por máquina de este modelo.

El cambio que recomendamos, y por qué no le cuesta nada

Todos los modelos de edición que operamos, con precio por imagen:

Normalmente una migración es un canje: modelo más nuevo, factura más alta, aprobación necesaria. Esta no. Nano Banana 2 Lite es un 24% más barato que el editor heredado y va una generación por delante, lo que significa que la conversación con finanzas y la conversación de ingeniería terminan igual. Con mil ediciones al mes se queda unos $9 en el bolsillo y encima obtiene mejor salida.

Preferimos decirlo así de claro antes que mantenerle en un slug que sabemos que caduca. Si sus ediciones incluyen texto legible —fotos de packaging, pizarras de menú, creatividades localizadas—, suba por encima de Lite hasta Nano Banana Pro, que es donde Google puso el renderizado de texto multilingüe. Explore el resto en la categoría image-to-image o en nuestro catálogo de modelos.

Hábitos de edición que se trasladan al reemplazo

Una buena noticia sobre migrar: la disciplina de prompt se transfiere intacta, así que nada de lo que aprenda esta semana se pierde.

Nombre el cambio y después nombre las constantes. "Recolorea el sofá a lino óxido; deja los cojines, el patrón de la alfombra y la luz de la ventana sin tocar" aguanta mucho mejor que una descripción reescrita de la escena. El instinto de describir el cuadro entero viene del text-to-image, y en una edición compite con la referencia hasta que el modelo regenera en lugar de ajustar.

Cuando envíe dos o tres imágenes, diga qué es cada una dentro del prompt: nada más le indica al modelo que su segundo adjunto era una localización y no un segundo sujeto. Resístase también a apilar tres cambios en una sola llamada. Sepárelos, encadene la primera salida en la segunda, y gastará lo mismo con muchísima menos deriva.

Comprobaciones previas al despegue

SynthID siempre está activo. Google incrusta su watermark imperceptible en cada salida, y no hay parámetro en ningún proveedor para quitarlo. Resuelva eso frente a los contratos con sus clientes antes de construir.

Deje resolution en 1k: esta le cuesta dinero. Nuestro schema lleva el mismo campo resolution en toda la familia Nano Banana, así que este endpoint le aceptará 2k y 4k sin protestar. Los pesos de Google no los van a honrar. gemini-2.5-flash-image entrega 1K y nada por encima, así que un request enviado en 4k se factura con nuestro multiplicador ×2 —$0.0624 en lugar de $0.0312— y le devuelve exactamente la misma imagen 1K que habría recibido por la mitad de precio. Preferimos avisarlo antes que cobrarlo. Los niveles más nuevos sí tienen escalas de resolución reales: Nano Banana Pro renderiza de verdad hasta 4096×4096.

Ponga un recordatorio en el calendario, no un ticket en el backlog. El 2 de octubre de 2026 el modelo upstream deja de responder, y todo lo que siga apuntando a este slug —un cron job, un botón de cara al cliente, un batch nocturno— falla ese día. Cambiar una cadena ahora es mejor que depurarlo entonces.

Preguntas que recibimos sobre el editor heredado

¿Cuántas imágenes de referencia acepta Nano Banana edit-image?

Tres como máximo. La propia guía de Google para gemini-2.5-flash-image es incluir un máximo de tres imágenes en una entrada, y la calidad se degrada más allá de eso. Para compuestos más pesados, Nano Banana Pro maneja hasta catorce referencias repartidas en roles de personaje, objeto y estilo.

¿Qué le pasa a mi integración el 2 de octubre de 2026?

Los requests a google/nano-banana/edit-image dejan de tener éxito, porque Google retira los pesos subyacentes en todas partes, no solo en nuestra plataforma. Ningún proveedor puede seguir sirviendo un modelo que su fabricante ha apagado. Pásese a Nano Banana 2 Lite antes de esa fecha.

¿Nano Banana 2 Lite es realmente más barato que el modelo heredado?

Sí: $0.0238 por edición frente a los $0.0312 de aquí, una diferencia del 24%, y sobre pesos más nuevos. Google lo plantea igual, citando mejor calidad, generación más rápida y precios más bajos. Es esa mejora poco habitual que no trae ningún canje de coste asociado.

¿Cuánto cuesta la edición de imágenes con Nano Banana en E2X?

$0.0312 por imagen editada con la resolution 1k por defecto, un 20% por debajo de los $0.039 que registramos en fal.ai, en la API Gemini de Google y en OpenRouter el 26 de agosto de 2026. Adjuntar una referencia o tres cuesta lo mismo, pero enviar resolution: "4k" aplica un multiplicador ×2 por una salida que este modelo no puede producir realmente: déjelo en 1k. Vuelva a comprobar la página del modelo en vivo antes de comprometer un presupuesto.

¿Puede editar o traducir texto dentro de una imagen?

No de forma fiable. El renderizado avanzado de texto pertenece a la generación Gemini 3, y este modelo es anterior, así que las palabras editadas suelen volver distorsionadas o reinterpretadas. Nano Banana Pro es el nivel construido para texto legible y multilingüe dentro de la imagen.

¿La imagen editada conserva un watermark?

Sí. SynthID va incrustado en cada salida de este modelo, exactamente igual que en la capability text-to-image. Es el marcador de procedencia de Google y ningún proveedor ofrece forma de desactivarlo.

¿Cuál es la diferencia entre las capabilities de edición y text-to-image?

Mismos pesos, mismo precio de $0.0312, entrada distinta. Edit-image requiere image_urls junto a su prompt y modifica lo que usted le da; text-to-image toma solo un prompt y construye desde cero. Elija según si ya existe una imagen de origen.