Introducción
LTX 2.5 Imagen a video anima un cuadro inicial que tú proporcionas durante 5 a 20 segundos completos, a 720p, 1080p, 2K o 4K. image_url y prompt son obligatorios; last_image_url agrega un cuadro final opcional, y duration_seconds, resolution y seed funcionan igual que en Texto a video. No existe el campo aspect_ratio: el cuadro inicial fija sujeto y composición y define la forma de la salida. Los clips vuelven con una banda sonora generada y las tareas se ejecutan de forma asíncrona. Sube solo imágenes que tengas autorización para usar; el uso del resultado es tu responsabilidad.
Elige el modo según el material inicial
| Material inicial | Modo |
|---|---|
| Un brief escrito define escena, acción, cámara y, cuando corresponde, sonido. | LTX 2.5 Texto a video |
| Una imagen inicial aprobada fija sujeto y composición; la instrucción dirige el movimiento posterior. | LTX 2.5 Imagen a video |
Funciones y aspectos destacados
El cuadro inicial se sigue de cerca
La identidad, el vestuario, el escenario y la luz salen de image_url, y ese cuadro se sigue de cerca. Es el camino confiable hacia un resultado literal: un cuadro inicial sin censura vuelve tal cual y no suavizado. Como la imagen ya lleva el aspecto visual, el prompt solo tiene que describir lo que cambia después.
Un cuadro opcional para el final del plano
last_image_url fija la composición final y solo es válido junto con image_url. Restringe el final, no el recorrido: el movimiento entre ambos cuadros se sigue generando y, en un clip largo, la parte central puede alejarse bastante. Dos cuadros que no coinciden en luz o vestuario producen una negociación visible entre ellos, así que prepáralos como un par continuo.
La misma duración, resolución y sonido que el endpoint de texto
duration_seconds va de 5 a 20 segundos completos, y los clips más largos se alejan más de un cuadro final entregado. resolution ofrece 720p (por defecto), 1080p, 2k (unos 2560 px de ancho) y 4k. La salida incluye una pista de audio generada sin campo para desactivarla; planea silenciarla o reemplazarla en la edición cuando necesites tu propia mezcla.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio. Describe qué cambia después del cuadro —acción, cámara, luz— y no el cuadro en sí. mínimo 1 caracteres |
image_url | Sí | El cuadro de apertura. Fija el sujeto y la composición, y define la forma de salida. |
last_image_url | No | Cuadro de cierre opcional, válido solo junto a |
resolution | No | 720p, 1080p, 2k o 4k. 2k sale con unos 2560 px de ancho. |
duration_seconds | No | Segundos enteros, de 5 a 20. Cuanto más largo el clip, más se aleja de un cuadro de cierre entregado. |
seed | No | Mantenla constante cuando subas la resolución, para que solo haya cambiado una variable. |
Precios
| Especificación | Precio |
|---|---|
| $0.09 / segundo |
| $0.13 / segundo |
| $0.19 / segundo |
| $0.30 / segundo |
Casos de uso
Un cambio de hora del día entre dos cuadros aprobados
En el ejemplo beach-to-bonfire, image_url muestra a una pareja en la playa al atardecer y last_image_url a los mismos dos de noche, envueltos en una manta junto a una fogata. La solicitud dura 10 segundos en 1080p, y el prompt describe el tránsito y no el destino: el sol que baja y la luz del fuego que toma el relevo. Fijar el final permite que el modelo invente la parte central sin desviarse más allá de un cuadro ya aprobado.
De un storyboard al siguiente para la edición
Cuando un plano tiene que empezar en un cuadro del storyboard y terminar en otro, envía ambos como image_url y last_image_url. La composición de salida empalma entonces con el corte siguiente, y eso hace que un clip generado sirva dentro de una línea de tiempo y no solo como pieza aislada.
Movimiento para una imagen terminada
El cuadro de candlelit-tub ya contiene las velas, el esmalte y la seda esmeralda mojada, así que su prompt solo cubre el cambio: hundirse en el agua, pasar las manos por el cabello empapado, abrir los ojos hacia la cámara. El ejemplo deco-pool-backfall es en cambio un momento físico: una caída de espaldas al agua, burbujas que suben y reflejos que recorren las columnas mientras la cámara se hunde con ella.
Guía de prompts y consejos prácticos
Describe lo que cambia, no lo que ya está
Todo lo que se ve en el cuadro inicial lo fija la imagen. Usa el prompt para decir quién se mueve, en qué dirección y a qué velocidad, y después la cámara y los cambios de luz. El prompt de candlelit-tub empieza con la primera acción ("She pushes up off the rim of the tub") y cierra con "Slow drift-in, warm candle light only".
Nombra la llegada cuando envíes un cuadro final
Con last_image_url, indica en el prompt que el plano termina en el cuadro final entregado y describe lo que ocurre en el camino. El brief de la fogata hace exactamente eso: "Begin on the two of them on the beach at sunset and end on the supplied final frame". Iguala sujeto, vestuario y luz entre las dos imágenes antes de escribir nada.
Ajusta la duración a la distancia recorrida
Los ejemplos de una sola acción duran 5 segundos; la transición del atardecer a la noche usa 10. Empieza con un clip corto y revisa sujeto, bordes, luz y continuidad de cámara en toda la salida antes de alargarlo. Recorre cuadro por cuadro las tomas con agua, como el ejemplo de la piscina, porque en el agua es donde una imagen animada suele desarmarse.
Dirige el sonido y fija la seed
Como el audio siempre se genera, escribe el sonido en el prompt: el brief de la piscina pide "no music, only muffled underwater tone". Cuando el movimiento esté bien, deja seed y el prompt sin cambios y sube solo resolution. La seed hace comparables las pasadas, no idénticas cuadro por cuadro, así que revisa otra vez el render final a resolución completa.
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": "lightricks/ltx-2.5/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# 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.
