Introducción
Envía fuentes de imagen numeradas y una instrucción que describa los cambios deseados y los detalles que se deben conservar.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Imagen |
| Empresa y modelo | Google; Gemini 3.1 Flash Lite Image |
| Flujos disponibles | Texto a imagen e imagen a imagen |
| Nivel de salida | 1K; aproximadamente un millón de píxeles |
| Capacidad del prompt | Hasta 20.000 caracteres |
| Relaciones fijas | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1 |
| Generación predeterminada | 1:1 |
| Opción de relación para editar | auto, además de catorce relaciones fijas |
| Imágenes de edición | De 1 a 10; identifícalas como Image 1, Image 2 y siguientes |
| Base del precio | Fijo por imagen; sin cargo por solicitudes fallidas |
| Filtro de contenido | El desarrollador aplica su filtro; rechaza sin cargo las solicitudes marcadas |
| Conservación de archivos | Al cumplirse 14 días, se procede a eliminar los archivos generados |
Funciones y aspectos destacados
La misma pareja con poses cambiantes
La generación 1:4 produjo una tira de cabina en blanco y negro con cuatro cuadros: risa, beso, tirón juguetón de corbata y frentes juntas. La pareja se mantuvo consistente. Escribe momentos en orden y elige la relación estrecha en controles; la salida es una sola imagen con cuatro cuadros dentro. Demuestra esa secuencia sin prometer lo mismo para cualquier reparto o diseño.
Un rincón de lectura en un vagón
El tren parte de un lugar y contraste: lectura acogedora dentro, lluvia afuera. La prueba produjo el rincón del vagón. Concreta muebles y luz y elige proporciones que dejen espacio a ventana y asiento. La salida 1K sirve para revisar composición antes de decidir si necesitas una versión mayor.
Luz invernal entre plantas verdes
El invernadero soleado se volvió mañana de invierno. Apareció escarcha y luz fría, manteniendo plantas interiores verdes. Facilita revisar el cambio: compara vidrio y luz y después vegetación por separado. Nombra el invernadero Image 1 y explicita tanto estación como conservación sin dejarla implícita.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Explica la modificación solicitada en hasta 20.000 caracteres y llama a las entradas Image 1, Image 2 y así sucesivamente; la extensión del texto no afecta la tarifa fija. mínimo 1 caracteres · máximo 20000 caracteres |
image_urls | Sí | Envía de 1 a 10 URL de imágenes de origen para guiar la modificación; este modo cobra por imagen producida y no por cantidad de fuentes. mínimo 1 elementos · máximo 10 elementos |
aspect_ratio | No | Elige auto para seguir el origen, o 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8 u 8:1; seleccionar una forma no modifica los precios de Lite. |
Precios
$0.027 / imagen
La edición con Lite aplica un cargo fijo por imagen generada, sin importar la proporción o la cantidad de fuentes; las modificaciones fallidas no se cobran.
Casos de uso
Historia en tira fotográfica
Distribuye una pareja en cuatro momentos de una composición estrecha 1:4. La cabina en blanco y negro mantuvo reconocible a la misma pareja mientras cambiaban las poses.
Estudio de ambiente interior
Explora luz cálida frente a lluvia exterior antes de desarrollar un concepto de habitación. La prueba del vagón llevó un rincón de lectura a ese entorno.
Revisión estacional de un lugar
Pide atmósfera invernal nombrando detalles interiores por conservar. La edición del invernadero añadió vidrio escarchado y luz fría con plantas aún verdes.
Lienzos para destinos poco comunes
Selecciona 1:8, 8:1 u otra relación si el diseño necesita una imagen estrecha o panorámica. Cambian composición sin añadir un nivel mayor de resolución.
Encargos con referencias numeradas
Usa de una a diez fuentes si la edición necesita material visual existente. Explica cada papel y revisa los detalles recibidos frente a las fuentes.
Guía de prompts y consejos prácticos
Escoge el punto de partida
Abre texto a imagen para una escena escrita o imagen a imagen para revisar una fuente. Usa fotos autorizadas de personas adultas sin suplantar a nadie.
Da una dirección visual clara
Nombra lugar, luz y acción visible. En edición, vincula entradas a Image 1, Image 2 y siguientes; separa cambios solicitados y detalles por mantener.
Selecciona proporciones de lienzo
Elige una relación fija al generar, como 1:4 para tira vertical. La edición añade auto para seguir proporciones de origen; todo permanece en 1K.
Revisa y descarga la imagen
Contrasta personas, objetos y encuadre con el encargo antes de aceptar. Guarda dentro de 14 días con el prompt y los ajustes usados.
Revisa una imagen con dirección escrita
Nano Banana 2 Lite imagen a imagen recibe material existente y un prompt de revisión. Aporta una a diez imágenes, identifícalas por número y explica cambios y conservación. La salida sigue en 1K, cerca de un millón de píxeles. Sirve para estudiar lugar o luz si la fuente contiene detalles por mantener.
El invernadero demuestra cambio estacional: del sol pasó a mañana invernal con escarcha y luz fría, conservando plantas verdes. Respalda esa edición, sin garantizar áreas idénticas fuera de lo pedido.
Parámetros para revisar
| Parámetro | Entrada admitida | Uso |
|---|---|---|
| prompt | Hasta 20.000 caracteres | Fuentes numeradas, cambios y detalles por conservar |
image_urls | De una a diez URLs de fuentes | Alinea Image 1, Image 2 y siguientes con el orden |
aspect_ratio | auto, o 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8 u 8:1 | auto sigue proporciones de origen; también lienzo fijo |
Edición añade auto a las catorce relaciones de generación. Elígelo deliberadamente si importa la forma fuente. Con varias entradas no asumas proporciones iguales; fija relación si el destino exige una. Ninguna selección aumenta el nivel de salida.
Aclara funciones de referencia
Vincula cada entrada a un propósito
El número debe indicar dónde mirar. Empieza con «Usa el invernadero de Image 1» y describe el invierno. Si añades imágenes, explica aportación de Image 2 y siguientes. Comprueba etiquetas frente al orden de image_urls antes de enviar.
Aceptar diez imágenes no promete consistencia para conjuntos complejos. Google dice que Lite no está optimizado para múltiples referencias ni edición secuencial de varias rondas. El invernadero es un cambio focalizado sin establecer fiabilidad de cadenas largas.
Separa cambio y conservación
Divide instrucciones: «Añade escarcha al vidrio y enfría la luz. Mantén verdes las plantas interiores». Aclara el contraste. En tu escena, nombra estructuras u objetos importantes y contrástalos con el original al recibir.
La muestra respalda vidrio escarchado, luz fría y vegetación verde. Puedes pedir conservar sendero o plantación, pero inspecciónalos sin confundir solicitud con resultado medido. Dedica el texto a requisitos visibles sin repetir solicitudes generales de calidad.
Usa retratos con permiso
Utiliza fotos autorizadas de adultos sin suplantar a nadie. En encargos nuevos, identifica personas de treinta años o más y describe ropa, expresión, luz y lugar. Aclara requisitos de identidad y compara la apariencia con la fuente autorizada antes de usar.
Una dirección de luz posible: «Usa el retrato autorizado de la mujer de unos cuarenta años en Image 1; añade luz cálida de estudio contra fondo azul; conserva chaqueta azul marino y pose sentada». Es un patrón sugerido sin resultado de retrato probado.
Contrasta edición y fuente
Usa el invernadero como secuencia práctica:
- Compara vidrio y luz para comprobar la atmósfera estacional pedida.
- Inspecciona vegetación interior para verificar el verde conservado.
- Revisa composición y entorno antes de decidir si sirve.
- Guarda juntos fuente, instrucción, relación y salida aceptada.
Para otra revisión, identifica el problema restante. Un seguimiento concreto se evalúa mejor que cambiar simultáneamente estación, muebles, cámara y estilo. Las notas no miden historiales largos ni tiempos de edición.
Facturación y límites operativos
Cada imagen producida tiene precio fijo; la relación no altera el cargo y los fallos no se cobran. La página del modelo muestra el precio vigente: consúltalo al estimar sin basarte en un importe copiado a una guía.
El desarrollador filtra contenido y rechaza sin cargo lo marcado. Usa el mismo límite de aceptación para revisiones y nuevas imágenes. Se conservan archivos 14 días antes de eliminarlos: descarga ediciones y guarda originales en tu proyecto.
Cuándo encaja otro endpoint
Usa Lite texto a imagen para composiciones sin fuentes. La tira generada muestra cuatro cuadros; este endpoint parte de referencias. Si necesitas 2K o 4K, Nano Banana 2.1 incluye esos niveles; Lite sigue siendo 1K a menor precio. Elige por material, tamaño y detalle que debas verificar.
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-lite/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.







