Pro API : générer des vidéos avec son
Un clip à partir d'un prompt, ou une animation d'une image fixe que tu fournis. Le fichier est un MP4, avec son si tu le demandes.
Soumettre une vidéo
POST /videos
{ "prompt": "a woman in a white linen dress walks along a beach at sunset, wind in her hair, she turns and smiles at the camera",
"width": 1080, "height": 1920, "audio": true }
| Champ | Type | Défaut | Ce que ça fait |
|---|---|---|---|
prompt | string | required | L'action, l'ambiance, la lumière. Décris le mouvement. |
width, height | int | 720 x 1280 | Vertical par défaut. Voir la grille de tarifs ci-dessous. |
mode | string | ltx25 | ltx25 : moteur 2.5 (son, durée automatique, 1080p, image de fin). turbo : la voie rapide et économique en 480p, sans image de fin. |
duration_auto | bool | true | Le moteur détermine la durée à partir du prompt, et length devient un plafond. Mets false pour une durée fixe. |
length | int | 121 | Durée (ou plafond) en frames à 24 fps, toujours de la forme 8n+1 : 73 (3 s), 121 (5 s), 241 (10 s), 361 (15 s), 481 (20 s). |
audio | bool | false | Son généré en même temps que l'image (ambiance, voix). |
image | string | Image de début en base64 : la vidéo anime cette image. | |
end_image | string | Image de fin en base64, en complément de image : le clip fait la transition entre les deux (moteur 2.5 uniquement). | |
lora, lora_strength | string, number | Un personnage entraîné sur le compte (name issu de GET /loras) et son intensité (0 à 1). | |
lora2, lora2_strength | string, number | Un second personnage. | |
steps | int | engine | Laisse vide. |
La réponse :
{ "jobId": "...", "seed": 908172, "cost": 30 }
Le coût est calculé et annoncé à la soumission, avant tout débit.
Formats et tarifs
Une vidéo est facturée au format, à tarif fixe indépendant de sa durée. Base : 5 crédits.
| Format | Petit côté | Exemples de tailles | Sans son | Avec son |
|---|---|---|---|---|
| 480p | 480 | 480 x 832, 832 x 480 | 5 | 10 |
| 720p | 720 | 720 x 1280, 1280 x 720 | 10 | 20 |
| 1080p | 1080 | 1080 x 1920, 1920 x 1080 | 15 | 30 |
La voie turbo applique une tarification différente : 480p, 1 crédit par 2,5 secondes (5 s = 2 crédits, 10 s = 4),
son inclus, sans image de fin.
Suivi, téléchargement, annulation
Les mêmes routes que pour les images, sous /videos.
GET /videos/{jobId}:pending/completed/failed, mêmes champs.GET /videos/{jobId}/file: le MP4 (Content-Type: video/mp4).POST /videos/{jobId}/cancel: annule la génération, rien n'est débité.
Une vidéo prend de 1 à 5 minutes, plus longtemps si le moteur démarre à froid. Interroge l'API toutes les 3 secondes et
télécharge dès que le statut est completed : le fichier n'est pas archivé.