API Pro: genera videos con sonido
Un clip a partir de un prompt, o una animación de una imagen fija que tú aportas. El archivo es un MP4, con sonido cuando lo solicitas.
Enviar 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 | Por defecto | Para qué sirve |
|---|---|---|---|
prompt | string | required | La acción, el ambiente, la luz. Describe el movimiento. |
width, height | int | 720 x 1280 | Vertical por defecto. Consulta la tabla de precios más abajo. |
mode | string | ltx25 | ltx25: motor 2.5 (sonido, duración automática, 1080p, fotograma final). turbo: el modo rápido y económico en 480p, sin fotograma final. |
duration_auto | bool | true | El motor elige la duración a partir del prompt y length se convierte en el límite máximo. Ponlo en false para una duración fija. |
length | int | 121 | Duración (o límite máximo) en fotogramas a 24 fps, siempre de la forma 8n+1: 73 (3 s), 121 (5 s), 241 (10 s), 361 (15 s), 481 (20 s). |
audio | bool | false | Sonido generado junto con la imagen (ambiente, voz). |
image | string | Fotograma inicial en base64: el video anima esta imagen. | |
end_image | string | Fotograma final en base64, junto con image: el clip transiciona de uno al otro (solo motor 2.5). | |
lora, lora_strength | string, number | Un personaje entrenado en la cuenta (name de GET /loras) y su intensidad (0 a 1). | |
lora2, lora2_strength | string, number | Un segundo personaje. | |
steps | int | motor | Déjalo vacío. |
La respuesta:
{ "jobId": "...", "seed": 908172, "cost": 30 }
El coste se calcula y se comunica al enviar, antes de que se descuente nada.
Formatos y precio
Un video tiene un precio por formato, como tarifa plana independiente de su duración. Base: 5 créditos.
| Formato | Lado corto | Tamaños de ejemplo | Sin sonido | Con sonido |
|---|---|---|---|---|
| 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 |
El modo turbo tiene un precio diferente: 480p, 1 crédito por cada 2,5 segundos (5 s = 2 créditos, 10 s = 4),
sonido incluido, sin fotograma final.
Consultar estado, descargar, cancelar
Las mismas rutas que para imágenes, bajo /videos.
GET /videos/{jobId}:pending/completed/failed, mismos campos.GET /videos/{jobId}/file: el MP4 (Content-Type: video/mp4).POST /videos/{jobId}/cancel: cancela el trabajo y no se cobra nada.
Un video tarda entre 1 y 5 minutos, más cuando el motor arranca en frío. Consulta el estado cada 3 segundos y
descarga el archivo en cuanto el estado sea completed: el archivo no se archiva permanentemente.