Introducción
Nano Banana 2 Texto a imagen es el Gemini 3.1 Flash Image de Google, lanzado el 26 de febrero de 2026, que genera imágenes a partir de un prompt escrito. Google lo describe como calidad de imagen de nivel Pro a velocidad Flash. Genera en cuatro niveles de tamaño de 0.5k a 4k en catorce formatos hasta 8:1 y puede buscar en la web e imágenes de referencia antes de dibujar, desde muy por debajo de las tarifas de Google.
Elige el modo según tu material de partida
| Lo que tienes | Modo |
|---|---|
| un brief escrito | Nano Banana 2 Texto a imagen |
| una imagen que quieres cambiar | Nano Banana 2 Edición de imagen |
Funciones y aspectos destacados
Ruta económica y Official fallback
Las solicitudes empiezan en una ruta económica, a un precio muy por debajo del precio de lista de Google. Con Official fallback (activado de forma predeterminada), una solicitud que esa ruta no puede completar vuelve a ejecutarse en la ruta oficial al precio oficial. En ambos casos el modelo es Gemini 3.1 Flash Image de Google, con los niveles de tamaño que Google publica para Nano Banana 2.
Cuatro niveles, catorce formatos
De borradores de 512 píxeles a finales de 4096 píxeles, y de torres 1:8 a banners 8:1. El formato nunca cambia el precio; solo el nivel de tamaño. En 2k nuestro banner 4:1 salió de 4128 píxeles de ancho.
Búsqueda antes de dibujar
La búsqueda web trae datos actuales como fechas, clima y lugares emblemáticos; la búsqueda de imágenes trae fotos de referencia de lugares y productos reales. Ambas son interruptores opcionales de la solicitud.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 5.000 caracteres. Describe el sujeto, el escenario, la luz y el lente con frases completas; las palabras entre comillas se escriben como texto en la imagen. mínimo 1 caracteres · máximo 5000 caracteres |
aspect_ratio | No | Uno de catorce formatos, incluidos los banners extremos 4:1, 1:4, 8:1 y 1:8; 16:9 de forma predeterminada. El formato no cambia el precio. |
resolution | No | 0.5k, 1k (predeterminado), 2k o 4k. Una imagen cuadrada mide 512, 1024, 2048 o 4096 píxeles de lado; cada nivel tiene su propio precio. |
enable_web_search | No | Desactivado de forma predeterminada. Al activarlo, el modelo consulta datos actuales como el clima, fechas o lugares emblemáticos antes de dibujar. Valor predeterminado: |
enable_image_search | No | Desactivado de forma predeterminada. Al activarlo, el modelo busca imágenes de referencia en la web antes de dibujar, útil para lugares y productos reales. Valor predeterminado: |
official_fallback | No | Activado por defecto. Cada solicitud se ejecuta primero por la ruta económica. Valor predeterminado: |
Precios
Se cobra por imagen según el nivel de tamaño; la relación de aspecto no cambia el precio. Cada solicitud empieza en la ruta económica, al precio económico. Con Official fallback (activado de forma predeterminada), una solicitud que la ruta económica rechaza o no puede completar vuelve a ejecutarse en la ruta oficial al precio oficial, así que la cotización muestra el precio inicial y el monto máximo; desactívalo para pagar solo el precio económico. Las solicitudes en 0.5k o con búsqueda web o búsqueda de imágenes pasan por la ruta oficial, y cada búsqueda suma un cargo. En la ruta oficial, un rechazo que llega como una breve respuesta de texto en lugar de una imagen cuenta como una generación completada y se cobra al precio oficial; los demás rechazos no se cobran.
| Especificación | Precio |
|---|---|
| $0.036 / imagen |
| $0.0384 / imagen (Con Official fallback: hasta $0.0536) |
| $0.0602 / imagen (Con Official fallback: hasta $0.0808) |
| $0.0902 / imagen (Con Official fallback: hasta $0.1208) |
Casos de uso
Cabeceras web y vallas
Banners ultra anchos 4:1 y 8:1 generados como una sola fotografía continua, sin unir ni estirar después.
Borradores rápidos de moda y estilo de vida
Muchas direcciones por hora en 0.5k y 1k, y la mejor se vuelve a generar en 2k para la entrega.
Lugares y productos reales
Con la búsqueda de imágenes activada, las escenas en un lugar emblemático real o con un producto real pueden apoyarse en fotos de referencia de la web.
Formatos altos para móviles
Imágenes altas 1:4 y 1:8 para historias y banners laterales, generadas como una sola imagen continua.
Guía de prompts y consejos prácticos
Da contenido a ambos extremos en formatos anchos
En 4:1 y 8:1, describe qué llena los bordes izquierdo y derecho: una playa larga, un horizonte urbano, una fila de fachadas. Si no, los extremos se vuelven cielo vacío.
Usa la búsqueda para datos, no para estilo
La búsqueda web ayuda cuando la imagen depende de algo actual o real. No mejora el estilo ni la composición, así que en otros casos déjala apagada.
Boceta en pequeño, entrega en grande
Mantén el prompt igual entre 0.5k y 4k; la composición se parece mucho, así que las decisiones tomadas en el borrador se mantienen.
Elige 2k para la entrega
En 2k una imagen cuadrada mide 2048 píxeles de lado, suficiente para la mayoría de las pantallas y páginas; deja 4k para impresión y recortes fuertes.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-2/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "16:9",
"enable_web_search": false,
"enable_image_search": false
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
