Introducción
Indica el sujeto, el entorno y la apariencia; después selecciona una de las catorce proporciones fijas.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| 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í | Describe la escena en hasta 20.000 caracteres; el prompt no tiene un nivel de precio independiente. mínimo 1 caracteres · máximo 20000 caracteres |
aspect_ratio | No | Selecciona 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; la generación usa 1:1 por defecto y todas las proporciones conservan el precio fijo por imag… |
Precios
$0.027 / imagen
La generación de texto con Lite cobra cada imagen con una tarifa fija; las proporciones no cambian el cargo y las tareas fallidas no se facturan.
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.
Una escena escrita en nivel 1K
Nano Banana 2 Lite texto a imagen crea desde descripción. Entrega 1K, aproximadamente un millón de píxeles, en catorce relaciones. Úsalo si partes de una idea: habitación, retrato, paisaje o tira fotográfica. Las imágenes existentes van a imagen a imagen cuando deban guiar una revisión.
Google indica baja latencia y costo. No medimos tiempos: es posicionamiento del desarrollador sin estimación de entrega. Las muestras documentan un rincón de lectura de vagón y una tira de cuatro cuadros.
Parámetros y lienzos
| Parámetro | Qué enviar | Comportamiento |
|---|---|---|
| prompt | Descripción de hasta 20.000 caracteres | Sujeto, entorno, acción y luz |
aspect_ratio | 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 | 1:1 por defecto; todo usa 1K |
La forma determina proporciones. «Tira fotográfica alta» explica composición, pero selecciona también 1:4. Un panorama puede usar 8:1 y 1:8 da un marco vertical estrecho. Redistribuyen la imagen sin añadir 2K o 4K. Generación no ofrece auto.
Escribe un prompt que puedas inspeccionar
Define la escena visible
Describe al sujeto central antes del ambiente. En el vagón, nombra asiento de ventana, lectura e iluminación y explica la lluvia. Los objetos concretos permiten contrastar con la salida. Una lista larga de sensaciones deja menos claras esas decisiones aunque el límite sea generoso.
Para personas, indica adultos de treinta años o más, ropa, expresión y lugar. Una pareja de casi cuarenta puede llevar vestido de noche y traje en cabina de luz suave. Describe su acción compartida sin entornos ajenos ni luces contradictorias.
Ordena la secuencia dentro de una imagen
La tira necesita disposición y personajes. Indica cuadros apilados verticalmente, misma pareja y acciones en orden. Mantén ropa y tratamiento fotográfico constantes. La salida es una imagen con cuadros, sin generar una colección de fotos separadas.
Una dirección útil: «Cuatro cuadros verticales de cabina de la misma pareja de casi cuarenta años, riendo, compartiendo un beso breve, acercándose por una corbata y juntando sus frentes; grano de película en blanco y negro». Combínala con aspect_ratio 1:4. Revisa cantidad, orden y apariencia reconocible antes de aceptar.
Registra las variaciones útiles
Al explorar, cambia algo específico, como color de lámpara o expresiones. Guarda prompt y relación con cada imagen aceptada para identificar la dirección preferida. Los ejemplos documentan salidas concretas sin garantizar mismas identidades o composición en otra solicitud.
Qué muestran las muestras
- El vagón produjo un rincón de lectura de tren con entorno reconocible.
- La cabina usó 1:4 y devolvió cuatro cuadros en blanco y negro. Risa, beso, tirón de corbata y frentes juntas con apariencia consistente.
- Son observaciones de esas composiciones: no establecen rendimiento de toda historia multicuadro ni tiempo de entrega medido.
La portada nueva es una ilustración, independiente de la tira generada. Usa muestra y ajustes para juzgar la salida observada.
Precio, filtro y conservación
Se cobra precio fijo por imagen. La relación no lo cambia y las solicitudes fallidas no se cobran. Consulta la tarifa actual en la página de Nano Banana 2 Lite antes de planear varias generaciones; esta guía describe la regla sin fijar importe.
El desarrollador aplica su filtro; rechaza sin cargo lo marcado. Aceptar un ejemplo no establece aceptar otro prompt. Los archivos duran 14 días y se eliminan después: descarga lo que conservarás.
Decide el siguiente flujo
Sigue con texto a imagen mientras defines una composición nueva 1K. Pasa al editor Lite para anclar cambios en una fuente: acepta una a diez entradas y añade auto. Para mayor salida, Nano Banana 2.1 ofrece 2K y 4K; Lite cuesta menos por imagen. Decide por nivel y material inicial sin esperar más resolución de otra relación.
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# 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.






