Pro API: gerar vídeos com som
Um clip a partir de um prompt, ou uma animação de uma imagem estática que forneces. O ficheiro é um MP4, com som quando o pedires.
Submeter um vídeo
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 | Padrão | O que faz |
|---|---|---|---|
prompt | string | obrigatório | A ação, o ambiente, a luz. Descreve o movimento. |
width, height | int | 720 x 1280 | Vertical por defeito. Consulta a tabela de preços abaixo. |
mode | string | ltx25 | ltx25: motor 2.5 (som, duração automática, 1080p, frame final). turbo: opção rápida e barata em 480p, sem frame final. |
duration_auto | bool | true | O motor escolhe a duração com base no prompt, e length passa a ser um limite máximo. Define como false para uma duração fixa. |
length | int | 121 | Duração (ou limite máximo) em frames a 24 fps, sempre da forma 8n+1: 73 (3 s), 121 (5 s), 241 (10 s), 361 (15 s), 481 (20 s). |
audio | bool | false | Som gerado em conjunto com a imagem (ambiente, voz). |
image | string | Frame inicial em base64: o vídeo anima esta imagem. | |
end_image | string | Frame final em base64, em conjunto com image: o clip faz a transição de uma para a outra (apenas motor 2.5). | |
lora, lora_strength | string, number | Uma personagem treinada na conta (name de GET /loras) e a sua intensidade (0 a 1). | |
lora2, lora2_strength | string, number | Uma segunda personagem. | |
steps | int | motor | Deixa em branco. |
A resposta:
{ "jobId": "...", "seed": 908172, "cost": 30 }
O custo é calculado e comunicado no momento da submissão, antes de qualquer débito.
Formatos e preço
Um vídeo é cobrado por formato, a uma taxa fixa independente da sua duração. Base: 5 créditos.
| Formato | Lado curto | Tamanhos de exemplo | Sem som | Com som |
|---|---|---|---|---|
| 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 |
A opção turbo tem uma tarifa diferente: 480p, 1 crédito por 2,5 segundos (5 s = 2 créditos, 10 s = 4),
som incluído, sem frame final.
Consultar, transferir, cancelar
As mesmas rotas que para imagens, em /videos.
GET /videos/{jobId}:pending/completed/failed, com os mesmos campos.GET /videos/{jobId}/file: o ficheiro MP4 (Content-Type: video/mp4).POST /videos/{jobId}/cancel: cancela, sem qualquer débito.
Um vídeo demora entre 1 a 5 minutos, mais tempo quando o motor arranca a frio. Faz polling a cada 3 segundos e
transfere assim que o estado for completed: o ficheiro não fica arquivado.