Lightricks
LTX 2.5 Fast
ltx-2.5-fast/image-to-video
Modèle de génération vidéo accéléré de Lightricks, prenant en charge la génération vidéo à partir de texte et à partir d'images, avec génération synchronisée de l'image et de l'audio, idéal pour une production rapide et la validation de prototypes
Essayer ltx-2.5-fast/image-to-video
Entrée
Créations
Voir toutes les créationsSortie
videoTarifs
ltx-2.5-fast/image-to-video per second
| Spécifications | Prix unitaire |
|---|---|
| 1080P | $0.086 |
Présentation
ltx-2.5-fast/image-to-video est un modèle rapide de génération de vidéo à partir d'image lancé par Lightricks, qui produit à partir d'une image fixe un clip vidéo accompagné d'un audio synchronisé. Il prend en charge l'interpolation entre première et dernière image, avec des durées de 2 à 20 secondes, des résolutions 720p ou 1080p, et un format paysage ou portrait combinables selon les besoins : idéal pour les développeurs qui souhaitent valider rapidement une direction de plan ou produire en série des clips courts.
Points clés
- Contrôle de la transition par interpolation entre première et dernière image — vous pouvez fournir une image de départ puis ajouter une image de fin, et le modèle génère une transition fluide entre ces deux points, ce qui facilite le verrouillage de la composition de début et de fin.
- Génération synchronisée de la vidéo et de l'audio natif — par défaut, l'audio natif est produit en même temps que l'image, ce qui réduit le travail de synchronisation audio-vidéo en post-production.
- Combinaisons flexibles de durée et de format — prise en charge de 2 à 20 secondes, de 720p ou 1080p, en paysage ou en portrait, pour basculer rapidement d'un format de sortie à l'autre selon le canal de diffusion.
Description des capacités
Génération de vidéo à partir d'image et interpolation entre première et dernière image : génère une vidéo animée à partir d'une image de départ ; si une deuxième image est ajoutée comme image de fin, le modèle interpole la transition entre le début et la fin, ce qui convient aux plans nécessitant un contrôle précis des images de début et de fin.
Paramétrage de la durée et du format : la durée peut être choisie entre 2 et 20 secondes par pas de deux secondes, la résolution prend en charge 720p et 1080p, et le format prend en charge 16:9 et 9:16 ; un seul appel suffit pour produire des contenus en paysage ou en portrait adaptés à la plateforme cible.
Génération synchronisée audio-vidéo : le paramètre generate_audio permet de contrôler si un audio natif est produit en même temps que la vidéo ; il est activé par défaut, ce qui convient aux cas où l'on souhaite obtenir directement un rendu final avec son.
Description de la scène et du mouvement de caméra par prompt : le champ prompt accepte jusqu'à 5000 caractères et permet de décrire simultanément la scène, le mouvement, le plan et le son, afin que le résultat généré corresponde mieux à l'intention de cadrage du créateur.
Cas d'usage
- Développeurs en validation rapide de prototype — générer rapidement un court extrait à partir d'une image conceptuelle et d'un prompt bref, tester à faible coût la direction de plan et le style, puis décider s'il faut passer à une production soignée.
- Production en série de contenus pour les réseaux sociaux et la publicité — générer séparément des clips de 2 à 20 secondes avec audio en 9:16 portrait et en 16:9 paysage, pour des diffusions en vidéo courte ou des variantes publicitaires en série.
- Création de plans de transition entre première et dernière image — fournir deux images, de début et de fin, pour générer une animation de transition intermédiaire, utile pour les transitions, les présentations de produits ou les plans de storyboard nécessitant une composition de début et de fin verrouillée.
Limites et conseils de choix
Ce modèle est une version optimisée pour la vitesse : au-delà de 10 secondes, seules les résolutions 720p ou 1080p sont prises en charge, avec une fréquence d'images limitée à 24/25 FPS ; les durées très longues et la haute résolution ne peuvent pas être satisfaites simultanément, il faut donc arbitrer entre durée et résolution selon le cas d'usage. Pour des sorties plus longues ou à fréquence d'images plus élevée, il convient d'évaluer d'autres versions de la même série. L'entrée doit contenir au moins une image de départ ; pour une génération à partir de texte seul, il faut se tourner vers la voie texte-vers-vidéo.
Questions fréquentes
Voir toutes les questions →-
Quelles résolutions LTX 2.5 Fast prend-il en charge ?
Deux niveaux : 720p et 1080p, avec 720p par défaut. C'est identique pour la génération de vidéo à partir de texte et à partir d'image.
-
Quelle est la durée maximale d'une vidéo générée ?
De 2 à 20 secondes, avec les options 2, 3, 4, 5, 6, 8, 10, 12, 14, 16, 18 et 20 secondes ; la valeur par défaut est de 6 secondes.
-
Prend-il en charge le mode portrait ?
Oui. Il suffit de définir aspect_ratio sur 9:16 pour obtenir une vidéo en portrait ; par défaut, c'est 16:9 en paysage.
-
Qu'est-ce que l'audio natif ? Y a-t-il un surcoût ?
Une fois generate_audio activé, le modèle génère en même temps des sons d'ambiance, des effets sonores ou une bande-son ; cette option est activée par défaut. Si vous la désactivez, vous obtenez une vidéo sans son, au même prix.
Créer une tâche de génération
https://api.hiapi.ai/v1/tasks En-têtes
AuthorizationstringRequisClé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API
Content-TypestringOptionnelLe corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.
Idempotency-KeystringOptionnelClé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.
En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.
Corps
modelstringRequisValeur fixe actuelle : ltx-2.5-fast/image-to-video
routestringOptionnelValeur fixe actuelle : default
inputobjectRequis
Objet de paramètres métier pour ltx-2.5-fast/image-to-video et la route default — voir le tableau des paramètres ci-dessous.
promptstringRequisminLength 1maxLength 5000Invite de texte servant à décrire la scène, le mouvement, la caméra et le son de l'image. Valeur de type chaîne de caractères.
durationintegerOptionnelDéfaut: 6min 2max 20Durée de la vidéo, en secondes. Valeur de type entier, par défaut 6.
2345681012Tout afficher (4)
14161820image_urlsarrayRequisminItems 1maxItems 2Tableau d'URL d'images de première et dernière image : la première URL correspond à la première image ; lorsqu'une deuxième URL est ajoutée, elle est utilisée comme dernière image. Formats jpeg, png et webp pris en charge.
Array [ string ]
resolutionstringOptionnelDéfaut: "720p"Résolution de la vidéo de sortie. Valeur de type chaîne de caractères, par défaut 720p.
720p1080paspect_ratiostringOptionnelDéfaut: "16:9"Rapport largeur/hauteur de l'image de sortie, utilisé pour choisir une sortie en paysage ou en portrait. Valeur de type chaîne de caractères, par défaut 16:9.
16:99:16generate_audiobooleanOptionnelDéfaut: trueIndique si l'audio natif doit être généré en même temps que la vidéo. Valeur booléenne, par défaut true.
callbackobjectOptionnel
Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.
Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.
urlstringRequisObligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.
whenstringOptionnelDéfaut: "final"Seul final est pris en charge pour l'instant — notifié sur success et fail.
finalstoragestringOptionnelDéfaut: "temp"Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.
temppersistentExemples de requête
# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ltx-2.5-fast/image-to-video",
"input": {
"prompt": "…",
"duration": 6,
"image_urls": "…",
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "ltx-2.5-fast/image-to-video",
input: {
"prompt": "…",
"duration": 6,
"image_urls": "…",
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "ltx-2.5-fast/image-to-video",
"input": {
"prompt": "…",
"duration": 6,
"image_urls": "…",
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": True
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtenir le détail de la tâche
https://api.hiapi.ai/v1/tasks/:id Champs de réponse
taskIdstringRequisIdentifiant de tâche, toujours préfixé tk-hiapi-.
modelstringRequisNom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.
routestringOptionnelPrésent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.
statusstringRequisStatut de la tâche.
queued En file, pas encore démarrée.
handling En cours de traitement.
archiving Traitement terminé, préparation des artefacts.
success Terminal : terminé, artefacts disponibles (output renvoyé).
fail Terminal : échec (error renvoyé).
Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.
creatednumberRequisDate de création de la tâche (secondes Unix).
completednumberRequisSecondes Unix de l'état terminal ; 0 tant que non terminal.
outputarrayOptionnel
Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).
Array [ object ]
Éléments du tableau
urlstringRequisURL de l'artefact, téléchargeable directement.
typestringRequisValeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.
expireAtnumberRequisSecondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.
errorobjectOptionnel
Présent uniquement si status == fail.
codestringRequisCode d'erreur métier.
messagestringRequisDescription de l'erreur.
Exemples de réponse
Succès
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En cours (non terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Échec
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articles
Voir tous les articles →-
Tutoriel
Tutoriel pour kandinsky-6.0-pro/image-to-video sur HiAPI : curl + Python
Lancer une requête image-vers-vidéo exploitable sur HiAPI : de l'envoi de la première image à l'interrogation asynchrone jusqu'au téléchargement final
-
Tutoriel
Utiliser Kandinsky 6.0 Pro texte-vers-vidéo sur HiAPI : tutoriel curl et Python
Démonstration pratique axée sur la requête : construire l'appel du prompt au clip vidéo, soumettre la requête, interroger l'état d'achèvement et télécharger le résultat
-
Tutoriel
Comment appeler hailuo-2.3/text-to-video via l'API HiAPI : curl, Python et exemples de requêtes exécutables
-
Tutoriel
Comment appeler hailuo-2.3-fast/image-to-video via l'API HiAPI : curl et Python en pratique
La première requête exploitable du palier image-vers-vidéo rapide et économique — de l'ID du modèle au téléchargement du MP4
-
Tutoriel
Comment utiliser kling-4.0/text-to-video via l'API HiAPI : curl, Python et un exemple de requête fonctionnel
Guide pratique pour les développeurs : prompts cinématographiques, audio synchronisé, interrogation asynchrone et téléchargement des sorties
-
Tutoriel
Comment appeler kling-4.0/image-to-video sur HiAPI : curl, Python et interrogation périodique
Modèles associés
Voir tous les modèles →Même type
-
HeyGen Avatar IV HeyGen $0.150 /seconde -
Hailuo 2.3 MiniMax $0.270 /vidéo -
Veo 3.1 Google $0.290 /seconde -
FLUX 3 Video Black Forest Labs $0.090 /seconde -
Seedance 2.0 ByteDance $0.017 /seconde -
Creatify Boreal Creatify $0.015 /seconde -
Kling 2.5 Kuaishou $0.060 /seconde -
Gemini Omni 1.1 Flash Google $0.450 /vidéo -
PixVerse V6 PixVerse $0.036 /seconde -
Ray 3.2 Luma $0.214 /vidéo -
Vidu Q3 Vidu $0.149 /seconde -
Wan 3.0 Video Alibaba $0.040 /seconde



