Introdução
LTX 2.5 Texto para vídeo gera, a partir de um briefing escrito, uma tomada contínua de 5 a 20 segundos inteiros, em 16:9 ou 9:16, em 720p, 1080p, 2K ou 4K. Só prompt é obrigatório; duration_seconds, aspect_ratio e resolution têm como padrão 5 segundos, 16:9 e 720p, e seed é opcional. Todo clipe volta com uma trilha sonora gerada. Use este endpoint quando ainda não existe nenhuma imagem aprovada e o cenário, a ação e a câmera precisam sair das palavras. As solicitações rodam como tarefas assíncronas: crie a tarefa e depois consulte o status ou aguarde o callback.
Escolha o modo pelo material inicial
| Material inicial | Modo |
|---|---|
| Um briefing escrito define cena, ação, câmera e, quando necessário, som. | LTX 2.5 Texto para vídeo |
| Uma imagem inicial aprovada fixa sujeito e composição; a instrução direciona o movimento seguinte. | LTX 2.5 Imagem para vídeo |
Recursos e destaques
Até vinte segundos numa única tomada
duration_seconds aceita segundos inteiros de 5 a 20; o mínimo é 5, não 3. Vinte segundos bastam para uma entrada, uma pausa e uma saída dentro de um único plano gerado, então a continuidade entre esses momentos se resolve na geração, e não na edição. Esta família de modelos não tem tarefa de extensão: a duração fica definida no envio, e um rascunho de cinco segundos e uma versão final de vinte são duas gerações separadas, não um clipe esticado.
Quatro resoluções atrás de um único campo
720p, 1080p, 2k e 4k saem todos do mesmo formato de solicitação, e 2k devolve um quadro com cerca de 2560 px de largura. A marcação de cena e o trajeto da câmera já dá para avaliar em 720p. O que os níveis mais altos acrescentam é a trama dos tecidos, a textura da pele e os brilhos especulares; por isso o caminho prático é um rascunho em 720p seguido de uma única passada em alta resolução com a mesma seed.
O som nasce junto com a imagem
O clipe traz uma faixa de áudio mesmo sem o endpoint ter campo de áudio, então não existe opção para desligá-la. Trate o som como parte do briefing: o exemplo da ópera termina com "orchestra tuning drifting up from the pit". Quando o clipe for para baixo da sua própria música e dos seus efeitos, silencie ou substitua a faixa na edição.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Escreva o arco inteiro como um plano: sujeito, ação, câmera, luz. Direção sem censura é aceita. pelo menos 1 caracteres |
resolution | Não | 720p, 1080p, 2k ou 4k. Rascunhe em 720p e rode o vencedor em 2k ou 4k. |
aspect_ratio | Não | Só 16:9 ou 9:16. Não existe quadro quadrado, 4:3 nem anamórfico aqui. |
duration_seconds | Não | Segundos inteiros, de 5 a 20. É parâmetro de geração, não corte — decida antes. |
seed | Não | Mantenha constante ao subir a resolução, para só uma variável ter mudado. |
Preços
| Especificação | Preço |
|---|---|
| $0.09 / segundo |
| $0.13 / segundo |
| $0.19 / segundo |
| $0.30 / segundo |
Casos de uso
Um movimento longo sem cortes
O exemplo arena-gate-to-cages usa os 20 segundos máximos, em 1080p e 16:9. O briefing descreve um único trajeto de Steadicam que sai do portão de uma arena, atravessa uma arquibancada lotada e um túnel iluminado por tochas e termina nas jaulas dos bastidores, e diz "No cuts" com todas as letras. Planos assim dependem de trajeto de câmera e cenário se manterem juntos ao mesmo tempo, e é exatamente para isso que serve uma tomada longa única.
Rascunhos que viram plates 4K
Faça o rascunho da tomada em 720p, mantenha a semente e depois rode o mesmo prompt uma vez em 4K; o campo de resolução é a única mudança. Um render 4K tem detalhe suficiente para aguentar uma gradação, um reenquadramento e um lento empurrão adicionados depois na edição. O exemplo copper-tub-candlelight foi renderizado em 2k; o briefing pede vapor, chama de vela e textura fina de superfície, o tipo de detalhe para o qual existem os níveis mais altos.
Vertical, primeira pessoa e estilo ilustrado
Em 9:16 e vinte segundos, uma passada de desfile cabe numa única geração, com entrada, giro e saída. O briefing bedside-pov estabelece logo na primeira frase que a câmera é uma pessoa recostada na cabeceira da cama, o que transforma uma cena observada numa cena que acontece com o espectador. Esta família não tem campo de estilo, então o exemplo ramen-stall define o visual cel-shaded apenas pela redação: "Anime cel-shaded animation, hand-painted backgrounds".
Guia de prompt e dicas práticas
Escreva o plano na ordem em que acontece
Mantenha o arco inteiro num único parágrafo e diga sujeito, ação, câmera e luz na ordem em que ocorrem. O briefing opera-staircase é um bom modelo: quem ela é e o que veste, depois a descida e a fenda que se abre a cada passo, depois a luz atravessando o tecido, depois "Slow crane down" e, por fim, o som. Coloque cada instrução de câmera ao lado da ação que ela acompanha.
Defina duração e formato antes da primeira palavra
Escolha primeiro duration_seconds e aspect_ratio, porque eles determinam quanta ação o briefing precisa carregar. O briefing de 20 segundos da arena encadeia vários lugares; os de 5 segundos descrevem, cada um, um único movimento e seu desfecho. Só existem 16:9 e 9:16: este endpoint não entrega formato quadrado nem 4:3.
Mude uma variável por passada
Mantenha seed fixa enquanto você reescreve uma linha ou sobe a resolução, para que a comparação isole essa única mudança. Uma seed fixa torna duas passadas comparáveis, mas não promete o mesmo clipe quadro a quadro; revise de novo a passada em alta resolução em vez de supor que ela bate com o rascunho.
Saiba onde a direção escrita para
Um plano escrito deixa figurino, corpo e enquadramento por conta do modelo, e as repetições variam, o que aparece mais em vinte segundos do que em cinco. Quando um rosto, um produto ou uma composição precisa ficar exatamente como foi aprovado, passe para o LTX 2.5 Imagem para vídeo e envie esse quadro em image_url.
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.5/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# 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.












