API de generacion de imagenes Nano Banana AI en 2026: ruta oficial de Gemini, eleccion de modelo y codigo funcional

Si hoy buscas el Nano Banana API oficial, en realidad no estas buscando un producto separado llamado Nano Banana para desarrolladores. Lo que buscas son los modelos nativos de generacion de imagen de Gemini dentro de Gemini API o Google AI Studio. Para la mayoria de casos de uso por API, el punto de partida mas seguro es Nano Banana 2, cuyo model ID oficial actual es gemini-3.1-flash-image-preview. Solo deberias subir a Nano Banana Pro (gemini-3-pro-image-preview) cuando la tarea justifique claramente el tier premium por mejor text rendering, mejor seguimiento de instrucciones complejas o una calidad propia de asset profesional.

Esta respuesta directa importa porque este query esta lleno de atajos engañosos. Algunas paginas tratan Nano Banana como si fuera una app independiente, otras presentan AI Mode como si fuera la API, y otras convierten el wrapper o gateway en la definicion misma del producto. No lo es. La forma correcta de verlo es mas simple: Nano Banana es la familia nativa de imagen de Gemini; la ruta oficial para desarrolladores es Gemini API + AI Studio; y el primer modelo que la mayoria de equipos deberia probar es Nano Banana 2.

Todos los model IDs, precios y limites de uso de consumo mencionados abajo se volvieron a verificar contra la documentacion, la ayuda y las paginas de precios vigentes de Google el 29 de marzo de 2026.

Resumen rapido

La version mas corta y correcta es esta.

La regla practica es esta: lee "Nano Banana API" como una pregunta sobre Gemini API, no como la busqueda de un unico sitio Nano Banana.

Que significa hoy Nano Banana API

La documentacion actual de image generation de Google define Nano Banana como la capacidad nativa de Gemini para generar imagenes, no como un solo surface. En practica, dentro del contexto API eso apunta a una familia pequena:

Muchos resultados del buscador siguen fallando justo aqui. El query suena como si debiera existir un unico "Nano Banana API", una unica pagina de producto, un unico flujo de cuenta y un modelo obvio. Google ya no lo presenta asi. La estructura correcta ahora es eleccion dentro de la familia + eleccion de surface:

• que version de la familia necesitas
• si necesitas la API oficial, la UI oficial de prueba o un surface de consumo

La segunda correccion importante es que la generacion de imagen ya forma parte del contrato normal de entrada y salida de Gemini, no esta escondida detras de otro producto de Google como una caja negra aparte. Las docs actuales ya muestran el request shape, image editing, control de aspect ratio, image size y search grounding. Google tambien deja claro que todas las generated images incluyen un SynthID watermark. Si tu producto necesita pensar en provenance o disclosure, ese detalle importa bastante.

Si tu pregunta real es mas amplia y quieres una vista general de las rutas de acceso en Gemini, AI Mode y el resto del stack de Google, lee nuestra guia amplia sobre Nano Banana AI image generator. Esta pagina es mas estrecha: responde solo a como entrar bien por la API oficial.

Que camino es API oficial y cual no

La forma mas rapida de confundirse es meter Gemini Apps, AI Mode, AI Studio, Gemini API y wrappers en el mismo saco. Estan relacionados, pero no son el mismo contrato.

Gemini API es la ruta programatica oficial. Si tu aplicacion necesita llamar a generateContent, enviar prompts o input images, recibir inline image output y controlar parametros como aspect ratio o image size, esta es la respuesta.

Google AI Studio es el surface oficial de testing y desarrollo alrededor del mismo stack. Sirve especialmente cuando quieres probar prompts, ver el comportamiento del modelo y validar resultados antes de meterlo en codigo. El rollout post oficial de Google del 26 de febrero de 2026 sobre Nano Banana 2 es importante porque deja explicito algo que muchos articulos no aclaran: para usar Nano Banana 2 en Google AI Studio necesitas un paid API key. AI Studio es, por tanto, la UI oficial del stack de desarrolladores, no un agujero gratis para evitar el pricing actual de las rutas preview.

Gemini Apps y AI Mode son surfaces reales de producto, pero pertenecen al mundo de consumo y no son la respuesta directa a un query de API. Gemini Apps Help separa hoy el papel de Nano Banana y Nano Banana Pro en uso cotidiano frente a advanced output, y AI Mode Help documenta por separado los image limits y el papel especial de Pro para infografias y diagramas. Esa informacion importa si eliges ruta como usuario. No cambia cual es el contrato de la API.

Wrappers y gateways son otra capa de decision de infraestructura. Pueden ser utiles si de verdad necesitas llamadas compatibles con OpenAI, routing multi-vendor o billing unificado. Pero esa es la segunda decision, no la primera. Si una pagina empieza actuando como si el gateway fuera el producto, ya te esta dando el punto de partida equivocado.

La regla minima de enrutamiento es esta:

• si vas a escribir codigo, usa Gemini API
• si quieres probar prompts en la UI oficial, usa AI Studio
• si en realidad no estas resolviendo un problema de API sino de uso cotidiano, usa Gemini Apps o AI Mode
• usa gateway solo cuando puedas nombrar claramente la razon de infraestructura

Empieza por Nano Banana 2 salvo que puedas explicar por que Pro merece el salto

Para la mayoria de lectores, aqui esta el juicio mas valioso.

Las docs actuales de image generation de Google describen Nano Banana 2 como la contraparte de alta eficiencia de Pro, optimizada para velocidad y casos de uso de alto volumen. Y el propio rollout post de Google de febrero de 2026 va mas lejos y llama a Nano Banana 2 "our best image generation and editing model." Leido como API guide, eso significa que no conviene asumir que Pro es el default solo porque suena mas premium.

Tiene sentido empezar por Nano Banana 2 cuando:

• estas construyendo tu primera integracion
• te importan la velocidad de iteracion y la eficiencia de coste
• esperas volumen real
• quieres un default seguro para image generation / editing general
• todavia no tienes una razon clara para pagar Pro

Tiene sentido subir a Nano Banana Pro cuando:

• la calidad del text rendering es central para el resultado
• la imagen es un final asset, no solo un borrador
• necesitas mas reasoning sobre instrucciones visuales complejas
• el trabajo es diagram-heavy, layout-sensitive o brand-critical

Y Nano Banana (gemini-2.5-flash-image) sigue teniendo sitio:

• si ya tienes un workload ajustado a esa fast route anterior
• si priorizas low latency por encima del comportamiento nuevo de Nano Banana 2

La clave es que esto no es solo una escalera de calidad. Es una cuestion de workload fit. Nano Banana 2 no es simplemente la version barata de Pro. Google lo esta colocando como default actual. Pro queda como premium override. Esa regla de decision es mucho mas util que el tipico "si quieres mejor calidad, usa Pro" que sigue apareciendo en paginas de wrappers.

Si despues de esta decision basica necesitas una comparativa mas profunda por workload, salta a nuestra comparacion Nano Banana Pro vs Nano Banana 2. En este articulo el objetivo es mas concreto: ayudarte a empezar bien.

Quickstart: saca a correr tu primer request

La ruta oficial es bastante mas corta de lo que dan a entender muchos tutoriales de terceros.

1. Crea tu Gemini API key

Empieza en Google AI Studio. Google hace facil la creacion del key, pero eso no significa que el image output actual sea gratis. Si lees el pricing actual de los preview image routes sin mezclar contratos, la conclusion honesta es esta:

• crear el key es facil
• usar los preview image models actuales es un paid API path

2. Instala el SDK oficial actual

La libraries page actual de Google pone como ruta recomendada el Google GenAI SDK, no los clientes legacy antiguos de Gemini.

bash

npm install @google/genai

# Python
pip install -U google-genai

Si ves snippets antiguos basados en google-generativeai, leelos como codigo historico, no como la mejor ruta actual.

3. Envia un request minimo de image generation

Para una nueva integracion, Nano Banana 2 basta como primer paso.

javascript
import { GoogleGenAI } from "@google/genai";
import fs from "node:fs";

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

const response = await ai.models.generateContent({
  model: "gemini-3.1-flash-image-preview",
  contents: "Create a clean editorial illustration of a robot sketching a website wireframe.",
  config: {
    responseModalities: ["IMAGE"],
    imageConfig: {
      aspectRatio: "16:9",
      imageSize: "2K",
    },
  },
});

for (const part of response.candidates[0].content.parts) {
  if (part.inlineData) {
    fs.writeFileSync("output.png", Buffer.from(part.inlineData.data, "base64"));
  }
}

La version en Python sigue exactamente la misma logica:

python
import os
from google import genai
from google.genai import types

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="Create a clean editorial illustration of a robot sketching a website wireframe.",
    config=types.GenerateContentConfig(
        response_modalities=["IMAGE"],
        image_config=types.ImageConfig(
            aspect_ratio="16:9",
            image_size="2K",
        ),
    ),
)

for part in response.parts:
    if part.inline_data is not None:
        part.as_image().save("output.png")

Si prefieres verificar el raw HTTP shape, el request REST oficial tambien es corto:

bash
curl -X POST \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
  -H "x-goog-api-key: ${GEMINI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [
        {"text": "Create a clean editorial illustration of a robot sketching a website wireframe."}
      ]
    }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K"
      }
    }
  }'

Pasar a Pro es deliberadamente aburrido: mantienes el mismo request shape y cambias el model ID a gemini-3-pro-image-preview. Esa es precisamente una de las razones por las que el workflow "empieza con Nano Banana 2 y sube a Pro solo cuando tengas una razon" es tan practico.

Que ya ofrece la API oficial antes de que disenes todo alrededor de un wrapper

La ruta oficial de Gemini merece ser tu baseline no solo por ser la oficial, sino porque su capability real ya es mas amplia de lo que sugieren muchas landing pages de gateways.

Image editing viene integrado. Las docs actuales de image generation muestran workflows text-and-image-to-image, no solo prompt-only generation. Si tu producto necesita editar, no solo generar una vez, eso importa.

Aspect ratio e image size son controles explicitos. La API oficial soporta imageConfig.aspectRatio, y para los preview image models actuales Google documenta image sizes desde 0.5K hasta 4K. Eso te permite gestionar de forma explicita el tradeoff entre coste y latencia dentro de tu propio producto.

Search grounding ya existe en el stack oficial. Las image-generation docs muestran google_search como tool oficial acoplable a la generacion de imagen. Resulta util para charts, weather visuals e infografias con contexto real. Pero no es "magia gratis": la pricing page trata el search grounding como una capa facturable una vez superada la shared free allowance.

SynthID ya lo gestiona la plataforma. Si te importa provenance, disclosure o etiquetado de contenido AI, este punto pesa bastante. Google documenta que todas las generated images incluyen un SynthID watermark.

Si aprendes Nano Banana primero a traves de un wrapper, estas ventajas se vuelven faciles de subestimar. Pero ese capability baseline es justamente lo que deberias evaluar antes de anadir otra capa.

Precio y frontera de "gratis": justo donde mas se mezcla todo

La mayor parte del mal advice sobre Nano Banana API se rompe exactamente aqui.

La Gemini Developer API pricing page actual muestra para ambos preview image models el estado Free Tier: Not available. A fecha de 29 de marzo de 2026, el pricing oficial es este:

Con esta tabla en mente, muchas paginas que rankean cambian de significado. Si una pagina da a entender que la Nano Banana preview-image API actual es "free to start" sin explicar el contrato, casi seguro esta mezclando:

• free key creation
• lenguaje de prueba en AI Studio
• consumer quotas de Gemini o AI Mode
• historias de free tier antiguas o de otra familia

No son el mismo contrato.

Las surfaces de consumo tienen sus propias reglas. Gemini Apps Help documenta hoy para Nano Banana 2 una estructura de 20 / 50 / 100 / 1000 images / day segun no plan / Google AI Plus / Google AI Pro / Google AI Ultra. AI Mode Help muestra la misma forma de 20 / 50 / 100 / 1000 images in a 24-hour period y ademas dice que Nano Banana Pro in AI Mode is optimized for infographics and diagrams. Todo eso sirve si estas decidiendo como usuario. No convierte la preview image API actual en una API gratis.

Si tu pregunta real es "cuanto cuesta Nano Banana como API", te ayudara mas saltar a nuestra guia de precios de Nano Banana 2 API y a la guia general de Gemini Image API 2026. Aqui estamos resolviendo primero la ruta y la puesta en marcha.

Decide en 30 segundos

Si solo quieres el arbol de decision minimo, es este:

Si vas a construir una nueva integracion oficial, usa Gemini API + Nano Banana 2.

Si la tarea depende de verdad de text rendering, visual fidelity o calidad de asset profesional, pasa a Nano Banana Pro.

Si primero quieres probar prompts en la UI oficial de Google, usa AI Studio.

Si no estas resolviendo una integracion API sino un uso de consumo, usa Gemini Apps o AI Mode.

Si necesitas wrapper, que sea porque puedes nombrar primero la razon de infraestructura, como routing compatible con OpenAI o billing multi-vendor.

Esa es la respuesta mas limpia y accionable para este query hoy.

FAQ

Que es exactamente la API oficial de Nano Banana?
Es la familia nativa de imagen de Gemini expuesta a traves de Gemini API y Google AI Studio, no un producto Nano Banana separado para desarrolladores.

Con que modelo conviene empezar?
En la mayoria de casos basta empezar con gemini-3.1-flash-image-preview, salvo que ya sepas desde el principio que necesitas el tier Pro.

Cual es el model ID oficial de Nano Banana Pro?
gemini-3-pro-image-preview.

Nano Banana API es gratis?
Segun la pricing page actual, los preview image models no tienen free tier de image output. Las cuotas de consumo y el uso de AI Mode son contratos aparte.

Que debo usar, AI Studio o Gemini API?
Lo razonable es usar ambos: AI Studio para validar prompts en la UI oficial y Gemini API para integrar en tu aplicacion.

AI Mode forma parte de la API?
No. AI Mode es un surface de consumo dentro de Search con sus propios image limits y comportamiento de producto.

La API soporta image editing y no solo text-to-image?
Si. Las image-generation docs de Google ya muestran workflows oficiales image-to-image.

Las imagenes generadas llevan watermark?
Si. Google documenta que las generated images incluyen SynthID watermark.

Y si aun asi necesito un gateway?
La API oficial de Gemini ya cubre muchos de los controles que de verdad importan a la mayoria de equipos: model selection, image editing, aspect ratio, image size y search grounding. Si aun asi no te basta, anade el gateway como una decision explicita de infraestructura, no como el punto de partida por defecto.