Introduction
LTX 2.5 Image vers vidéo anime une image d’ouverture que vous fournissez, pendant 5 à 20 secondes entières, en 720p, 1080p, 2K ou 4K. image_url et prompt sont obligatoires ; last_image_url ajoute une image de fin facultative, et duration_seconds, resolution et seed se comportent comme sur Texte vers vidéo. Il n’y a pas de champ aspect_ratio : l’image d’ouverture fixe le sujet et la composition et détermine le format de sortie. Les clips reviennent avec une bande son générée et les tâches s’exécutent de façon asynchrone. N’envoyez que des images que vous êtes autorisé à utiliser ; l’usage du résultat relève de votre responsabilité.
Choisir le mode selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| Un brief écrit définit la scène, l’action, la caméra et, si nécessaire, le son. | LTX 2.5 Texte vers vidéo |
| Une image de départ validée fixe le sujet et la composition ; la consigne dirige le mouvement qui suit. | LTX 2.5 Image vers vidéo |
Fonctionnalités et points forts
L’image d’ouverture est suivie de près
Identité, garde-robe, décor et lumière viennent de image_url, et cette image est suivie de près. C’est la voie fiable vers un résultat littéral : une image d’ouverture sans censure revient telle quelle plutôt qu’adoucie. Comme l’image porte déjà le rendu, le prompt n’a plus qu’à décrire ce qui change ensuite.
Une image facultative pour l’arrivée du plan
last_image_url fixe la composition finale et n’est valide qu’avec image_url. Elle contraint la fin, pas le trajet : le mouvement entre les deux images reste généré et, sur un long clip, le milieu peut s’égarer loin. Deux images qui divergent sur la lumière ou la garde-robe produisent une négociation visible entre elles ; préparez-les donc comme une paire continue.
Même durée, même résolution et même son que le point de terminaison texte
duration_seconds va de 5 à 20 secondes entières, et plus le clip est long, plus il s’éloigne d’une image de fin fournie. resolution propose 720p (par défaut), 1080p, 2k (environ 2560 px de large) et 4k. La sortie comprend une piste audio générée sans champ pour la désactiver ; prévoyez de la couper ou de la remplacer au montage si vous avez besoin de votre propre mixage.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire. Décrivez ce qui change après l’image — action, caméra, lumière — et non l’image elle-même. 1 caractères minimum |
image_url | Oui | L’image d’ouverture. Elle fixe le sujet et la composition, et définit la forme de sortie. |
last_image_url | Non | Image de clôture facultative, valide uniquement aux côtés de |
resolution | Non | 720p, 1080p, 2k ou 4k. Le 2k sort à environ 2560 px de large. |
duration_seconds | Non | Secondes entières, de 5 à 20. Plus le clip est long, plus il s’écarte d’une image de clôture fournie. |
seed | Non | Gardez-la constante quand vous montez la résolution, pour qu’une seule variable ait changé. |
Tarification
| Spécification | Prix |
|---|---|
| $0.09 / seconde |
| $0.13 / seconde |
| $0.19 / seconde |
| $0.30 / seconde |
Cas d’utilisation
Un changement d’heure entre deux images validées
Dans l’exemple beach-to-bonfire, image_url montre un couple sur la plage au coucher du soleil et last_image_url les mêmes deux personnes, la nuit, enveloppées dans une couverture près d’un feu de camp. La requête dure 10 secondes en 1080p, et le prompt décrit le passage plutôt que la destination : le soleil qui descend, la lumière du feu qui prend le relais. Fixer la fin permet au modèle d’inventer le milieu sans dériver au-delà d’une image déjà validée.
D’une planche à l’autre pour le montage
Quand un plan doit commencer sur une image de storyboard et finir sur une autre, envoyez les deux dans image_url et last_image_url. La composition de sortie raccorde alors avec le plan suivant, ce qui rend un clip généré utilisable dans une timeline et pas seulement comme pièce isolée.
Du mouvement pour une image finie
L’image de candlelit-tub contient déjà les bougies, l’émail et la soie émeraude mouillée ; son prompt ne décrit donc que le changement : s’enfoncer dans l’eau, passer les mains dans les cheveux trempés, ouvrir les yeux vers la caméra. L’exemple deco-pool-backfall est plutôt un moment physique : une chute en arrière dans l’eau, des bulles qui montent et des reflets qui rampent sur les colonnes pendant que la caméra descend avec elle.
Guide de prompt et conseils pratiques
Décrire ce qui change, pas ce qui est déjà là
Tout ce qui est visible dans l’image d’ouverture est fixé par l’image. Consacrez le prompt à qui bouge, dans quelle direction et à quelle vitesse, puis à la caméra et aux variations de lumière. Le prompt de candlelit-tub commence par la première action (« She pushes up off the rim of the tub ») et se termine sur « Slow drift-in, warm candle light only ».
Nommer l’arrivée quand vous envoyez une image de fin
Avec last_image_url, indiquez dans le prompt que le plan se termine sur l’image finale fournie et décrivez ce qui se passe en chemin. Le brief du feu de camp fait exactement cela : « Begin on the two of them on the beach at sunset and end on the supplied final frame ». Harmonisez sujet, garde-robe et lumière entre les deux images avant même d’écrire.
Adapter la durée à la distance parcourue
Les exemples à action unique durent 5 secondes ; la transition du coucher de soleil à la nuit en utilise 10. Commencez par un clip court et vérifiez sujet, contours, lumière et continuité de caméra sur toute la sortie avant de l’allonger. Parcourez image par image les plans aquatiques comme l’exemple de la piscine : c’est dans l’eau qu’une image animée se défait le plus souvent.
Diriger le son et verrouiller la seed
Comme l’audio est toujours généré, écrivez le son dans le prompt : le brief de la piscine demande « no music, only muffled underwater tone ». Une fois le mouvement juste, gardez seed et le prompt inchangés et ne montez que resolution. La seed rend les passages comparables, pas identiques image par image : revérifiez donc le rendu final en pleine résolution.
Démarrage rapide de l’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"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
