Introdução
LTX-2 19B Extensão de vídeo continua um clipe que você já tem. Envie-o em video_url com um prompt sobre o que acontece depois. O último quadro do clipe vira o quadro inicial de uma nova tomada de imagem para vídeo do LTX-2 19B, de 5 a 20 segundos, e as duas partes são unidas em um único MP4: primeiro o seu original, depois a continuação, sem o quadro repetido na emenda. O novo segmento também volta como arquivo próprio, para você continuar estendendo ou editar as partes separadamente.
Recursos e destaques
A continuidade vem do último quadro. Figurino, cenário, luz e a posição de cada pessoa se mantêm porque o novo segmento começa literalmente no seu último quadro. O movimento não passa da mesma forma: o modelo vê uma única imagem parada, não o clipe inteiro, então descreva o movimento que deve continuar em vez de supor que velocidade e direção serão mantidas.
Você recebe um arquivo e, à parte, a nova peça. O MP4 unido mantém a taxa de quadros e o enquadramento do seu clipe, sem faixas pretas. Para alinhar a emenda, a imagem pode ser cortada ou ajustada em poucos pontos percentuais nas bordas. Se o modelo devolver uma proporção bem diferente, o novo segmento é redimensionado para preencher o seu quadro, centralizado, e o que sobra é cortado. O arquivo é codificado como MP4 H.264 com som AAC. Cada novo segmento vem com uma trilha estéreo gerada na mesma passada e não há chave para desligá-la. O som do seu original permanece, e os dois são misturados com um breve fade cruzado na emenda, para o áudio passar sem corte seco. O segundo asset da saída é só o novo segmento, pronto para outra extensão ou para um editor.
Todo o resto é imagem para vídeo do LTX-2 19B. O novo segmento roda pelas mesmas rotas, com a mesma amplitude de conteúdo e o mesmo preço por segundo do endpoint de imagem para vídeo, e uma geração que falha é reembolsada do mesmo jeito. Se a geração der certo mas a emenda não puder ser montada, a tarefa falha e a cobrança é reembolsada.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Obrigatório. O que acontece depois: a ação seguinte, o movimento de câmera e o som em uma linha “Audio:”. pelo menos 1 caracteres |
video_url | Sim | O clipe a continuar: MP4, MOV ou WebM, até 60 segundos. O último quadro vira o quadro inicial do novo segmento, então corte-o em um quadro limpo e nítido. pelo menos 1 caracteres |
resolution | Não | Resolução do novo segmento: 480p, 720p ou 1080p, 720p por padrão. |
duration_seconds | Não | Duração do novo segmento: um número inteiro de 5 a 20 segundos, 5 por padrão. 20 segundos são uma única geração, não uma sequência emendada. |
seed | Não | De 0 a 2147483647. Mantenha fixa para comparar um campo alterado por vez; retire para ter variedade. |
Preços
Cobrado por segundo do novo segmento, na resolução escolhida; o clipe original que você envia não é cobrado.
| Especificação | Preço |
|---|---|
| $0.0144 / segundo |
| $0.0192 / segundo |
| $0.0288 / segundo |
Casos de uso
Alongue uma tomada que terminou cedo demais: um prato giratório de produto que para antes de o rótulo ficar de frente para a câmera, ou uma caminhada cortada antes de a pessoa chegar à porta. Estenda por alguns segundos e descreva só o movimento que falta.
Monte uma sequência mais longa passo a passo. Gere uma primeira tomada, estenda e depois estenda de novo o resultado unido; cada passo cobra só os segundos que acrescenta. Como cada passo parte de um único quadro, confira cada emenda antes de empilhar a próxima.
Guia de prompt e dicas práticas
Descreva o próximo momento, não a cena inteira. O quadro já define quem está onde; use o prompt para a ação seguinte, o movimento de câmera e o som, e termine com uma linha “Audio:” citando dois ou três sons. Repita a linguagem de câmera com que o clipe terminou, como uma aproximação lenta ou um plano fixo, para a emenda parecer uma única tomada.
Apare antes de estender. O último quadro é a única imagem que o modelo vê, então um final borrado, cortado no meio do movimento ou muito comprimido vai direto para a continuação. Corte primeiro o seu original em um quadro limpo e nítido. São aceitos originais de até 60 segundos em MP4, MOV ou WebM.
Mantenha a resolução coerente. A resolução define apenas a nitidez com que o novo segmento é gerado, então uma configuração menor deixa a parte nova mais suave que o original. Combine a resolução com a da origem e defina duration_seconds com a duração de que você realmente precisa: a cobrança acompanha apenas o novo segmento.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "lightricks/ltx-2-19b/video-extend",
"input": {
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.





