Introducción
Nano Banana 2 Edición de imagen ejecuta el Gemini 3.1 Flash Image de Google sobre imágenes que ya tienes. Acepta de una a catorce imágenes de origen, conserva el formato de origen o lo cambia a uno de catorce formatos, y genera en 0.5k, 1k, 2k o 4k.
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
Hasta catorce referencias
Combina personas, atuendos, escenarios y productos de hasta catorce imágenes, cada una descrita por su papel en el prompt. La ruta económica acepta hasta diez; con más, la edición pasa por la ruta oficial, donde cada imagen de origen suma un pequeño cargo fijo, así que pasa solo las que la edición necesita.
Reencuadra mientras editas
La relación de aspecto auto conserva el formato de origen; cualquiera de los catorce formatos reencuadra el resultado, como en nuestro ejemplo, donde un banner 4:1 se volvió una escena nocturna 16:9.
Rápido en cualquier tamaño
Los mismos niveles que texto a imagen, de borradores en 0.5k a finales en 4k, con un precio según el nivel; en la ruta oficial, cada imagen de origen suma un pequeño cargo.
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 |
image_urls | Sí | De 1 a 14 imágenes de origen. Indica en el prompt qué aporta cada una: la persona, el escenario, el producto. mínimo 1 elementos · máximo 14 elementos |
aspect_ratio | No | auto (predeterminado) conserva el formato de la imagen de origen; o elige uno de catorce formatos, incluidos los banners extremos 4:1, 1:4, 8:1 y 1:8. |
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 edición se ejecuta primero por la ruta económica. Valor predeterminado: |
Precios
Se cobra por imagen según el nivel de tamaño. Cada edición empieza en la ruta económica, al precio económico, sin cargo por imagen de origen. Con Official fallback (activado de forma predeterminada), una edición que la ruta económica rechaza o no puede completar, o una con más de 10 imágenes de origen, pasa por la ruta oficial al precio oficial, que además suma un pequeño cargo fijo por cada imagen de origen; desactívalo para pagar solo el precio económico. Las ediciones 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. La cotización muestra el precio inicial y el monto máximo de la edición. 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
Cambios de lugar y de hora del día
Lleva a una persona a un lugar nuevo o convierte el día en noche para una campaña, conservando el rostro, el atuendo y la pose.
Adaptar imágenes terminadas a otro formato
Convierte un banner ancho en una versión 16:9 o 9:16 con contenido nuevo en los bordes en lugar de un simple recorte.
Grupos de productos con estilo
Organiza varias fotos de producto en una sola escena con estilo, nombrando cada producto y dónde debe ir.
Guía de prompts y consejos prácticos
Enumera lo que debe quedarse
Después de describir el cambio, nombra el rostro, el cabello, el atuendo y la pose que quieres conservar; el modelo respeta una lista escrita.
Describe el cuadro nuevo al reencuadrar
Cuando cambie el formato, di qué debe contener el espacio añadido: más cielo, otra mesa, el resto de la calle.
Usa la búsqueda solo con referencias reales
Activa la búsqueda de imágenes solo cuando la edición dependa de un lugar o un producto real que el modelo necesite ver.
Prueba las ediciones en 0.5k
Prueba primero la instrucción en 0.5k; si el cambio se ve bien, ejecuta la misma solicitud en 2k o 4k.
Ajusta el nivel a la imagen de origen
Una edición no puede añadir detalle que la imagen de origen nunca tuvo; 2k suele bastar salvo que la imagen de origen sea grande.
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/edit",
"input": {
"aspect_ratio": "auto",
"enable_image_search": false,
"enable_web_search": false,
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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.
