Pro API: Videos mit Sound generieren
Ein Clip aus einem Prompt oder eine Animation eines Standbilds, das du selbst lieferst. Die Datei ist ein MP4, mit Sound wenn du das angibst.
Ein Video einreichen
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 }
| Feld | Typ | Standard | Was es tut |
|---|---|---|---|
prompt | string | erforderlich | Die Aktion, die Stimmung, das Licht. Beschreibe die Bewegung. |
width, height | int | 720 x 1280 | Standardmäßig vertikal. Siehe die Preistabelle unten. |
mode | string | ltx25 | ltx25: Engine 2.5 (Sound, automatische Dauer, 1080p, Endframe). turbo: die schnelle, günstige Spur in 480p, kein Endframe. |
duration_auto | bool | true | Die Engine ermittelt die Länge aus dem Prompt, und length wird zur Obergrenze. Setze false für eine feste Länge. |
length | int | 121 | Länge (oder Obergrenze) in Frames bei 24 fps, immer in der Form 8n+1: 73 (3 s), 121 (5 s), 241 (10 s), 361 (15 s), 481 (20 s). |
audio | bool | false | Sound wird zusammen mit dem Bild generiert (Ambiente, Stimme). |
image | string | Startframe in base64: das Video animiert dieses Bild. | |
end_image | string | Endframe in base64, zusammen mit image: der Clip geht von einem zum anderen über (nur Engine 2.5). | |
lora, lora_strength | string, number | Ein trainierter Charakter auf dem Account (name aus GET /loras) und seine Stärke (0 bis 1). | |
lora2, lora2_strength | string, number | Ein zweiter Charakter. | |
steps | int | Engine | Leer lassen. |
Die Antwort:
{ "jobId": "...", "seed": 908172, "cost": 30 }
Die Kosten werden bei der Einreichung berechnet und angekündigt, bevor irgendetwas abgebucht wird.
Formate und Preis
Ein Video wird pro Format berechnet, als Pauschalpreis unabhängig von seiner Länge. Basis: 5 Credits.
| Format | Kurze Seite | Beispielgrößen | Ohne Sound | Mit Sound |
|---|---|---|---|---|
| 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 |
Die turbo-Spur wird anders berechnet: 480p, 1 Credit pro 2,5 Sekunden (5 s = 2 Credits, 10 s = 4),
Sound inklusive, kein Endframe.
Abfragen, herunterladen, abbrechen
Dieselben Routen wie bei Bildern, unter /videos.
GET /videos/{jobId}:pending/completed/failed, gleiche Felder.GET /videos/{jobId}/file: das MP4 (Content-Type: video/mp4).POST /videos/{jobId}/cancel: bricht ab, und es wird nichts berechnet.
Ein Video dauert 1 bis 5 Minuten, länger wenn die Engine kalt startet. Frage alle 3 Sekunden ab und
lade sofort herunter, sobald der Status completed ist: die Datei wird nicht archiviert.