Pro API: genera video con audio
Un clip generato da un prompt, o l'animazione di un'immagine che fornisci tu. Il file è un MP4, con audio quando lo richiedi.
Invia un video
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 }
| Campo | Tipo | Default | Cosa fa |
|---|---|---|---|
prompt | string | required | L'azione, l'atmosfera, la luce. Descrivi il movimento. |
width, height | int | 720 x 1280 | Verticale per impostazione predefinita. Vedi la tabella dei prezzi qui sotto. |
mode | string | ltx25 | ltx25: motore 2.5 (audio, durata automatica, 1080p, frame finale). turbo: la modalità veloce ed economica in 480p, senza frame finale. |
duration_auto | bool | true | Il motore sceglie la durata dal prompt e length diventa un limite massimo. Imposta false per una durata fissa. |
length | int | 121 | Durata (o limite massimo) in frame a 24 fps, sempre nella forma 8n+1: 73 (3 s), 121 (5 s), 241 (10 s), 361 (15 s), 481 (20 s). |
audio | bool | false | Audio generato insieme all'immagine (ambiente, voce). |
image | string | Frame iniziale in base64: il video anima questa immagine. | |
end_image | string | Frame finale in base64, insieme a image: il clip transiziona dall'uno all'altro (solo motore 2.5). | |
lora, lora_strength | string, number | Un personaggio addestrato sull'account (name da GET /loras) e la sua intensità (da 0 a 1). | |
lora2, lora2_strength | string, number | Un secondo personaggio. | |
steps | int | engine | Lascia vuoto. |
La risposta:
{ "jobId": "...", "seed": 908172, "cost": 30 }
Il costo viene calcolato e comunicato al momento dell'invio, prima di qualsiasi addebito.
Formati e prezzi
Un video ha un prezzo per formato, come tariffa fissa indipendente dalla sua durata. Base: 5 crediti.
| Formato | Lato corto | Dimensioni di esempio | Senza audio | Con audio |
|---|---|---|---|---|
| 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 modalità turbo ha un prezzo diverso: 480p, 1 credito ogni 2,5 secondi (5 s = 2 crediti, 10 s = 4),
audio incluso, senza frame finale.
Polling, download, annullamento
Le stesse route delle immagini, sotto /videos.
GET /videos/{jobId}:pending/completed/failed, stessi campi.GET /videos/{jobId}/file: l'MP4 (Content-Type: video/mp4).POST /videos/{jobId}/cancel: annulla il job e non viene addebitato nulla.
Un video richiede da 1 a 5 minuti, di più quando il motore parte da freddo. Fai polling ogni 3 secondi e
scarica il file non appena lo stato è completed: il file non viene archiviato.