Introdução
O LTX 2.3 Spicy imagem para vídeo anima um quadro inicial sem censura, com orientação de movimento opcional e sem campo de áudio.
O LTX 2.3 Spicy é uma versão LoRA sem censura, baseada no LTX 2.3 da Lightricks, publicada como endpoints de imagem para vídeo e de video-extend; esta página trata o de imagem para vídeo. O quadro inicial que você envia carrega o conteúdo, o prompt é opcional e uma solicitação devolve de 3 a 20 segundos inteiros em 480p, 720p ou 1080p.
Recursos e destaques
Vinte segundos são uma cena, não um loop
A maioria dos endpoints de vídeo sem censura para em cinco ou seis segundos, o que obriga a transformar tudo em loop. Vinte segundos numa única geração bastam para um momento com começo, virada e fim, e a continuidade acontece dentro da tomada, não numa emenda que você precisa esconder. Para passar de vinte segundos, continue o clipe com o endpoint de extensão de vídeo.
A imagem decide o conteúdo
Não existe entrada só de texto, e essa é a ideia: o que está no quadro, ou seja, figurino, corpo, pose e enquadramento, é o que ganha movimento, então o seu material chega como foi enviado em vez de ser reinterpretado por um codificador de texto. Resolva a imagem primeiro numa passada barata e o pedido de vídeo vira só uma questão de movimento.
Você pode enviar só a imagem
O prompt é opcional. Um quadro sozinho gera um pequeno movimento plausível, que muitas vezes é tudo de que um loop precisa, e torna trivial processar em lote um ensaio de fotos existente. Acrescente texto só quando um momento específico importar, e limite-o ao que muda em vez de descrever a imagem de novo.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
preset | Não | Tuned é a combinação geral que recebe ajustes contínuos. Original quase não estiliza: escolha quando a predefinição briga com o visual que você descreveu. |
image_url | Sim | Obrigatório. O still que anima — ele decide o conteúdo e o formato de saída. |
prompt | Não | Opcional. Descreva a cena, a câmera e o ritmo; não redescreva o quadro. |
duration_seconds | Não | Segundos inteiros, de 3 a 20. Vinte é uma geração, não uma sequência costurada. |
resolution | Não | 480p, 720p ou 1080p. Vem em 480p — suba para qualquer coisa que você entregue. |
seed | Não | Torna duas execuções comparáveis quando você muda uma variável. Não é garantia de quadro idêntico. |
Preços
| Especificação | Preço |
|---|---|
| $0.019 / segundo |
| $0.038 / segundo |
| $0.057 / segundo |
Casos de uso
Cenas que outras APIs recusam
Quadros são aceitos e animados como chegam, então o material barrado pelo filtro de prompts em outros lugares roda aqui. Como o conteúdo está na imagem e não no texto, o clipe corresponde ao quadro aprovado, não a uma leitura suavizada das suas palavras.
Cenas de companhia de vinte segundos
Uma única geração cobre uma aproximação, uma pausa e um olhar que se desvia: a forma que um clipe de companhia ou de roleplay precisa para parecer um momento, e não um loop de dois segundos repetindo sem parar. Um quadro, um prompt, uma solicitação.
Movimento em lote para um ensaio existente
Como o prompt é opcional, um arquivo de imagens pode ser processado sem orientação por imagem: cada quadro vira um clipe de três segundos em 480p, e só os que valem a pena ganham uma passada mais longa em 1080p.
Guia de prompt e dicas práticas
Faça o quadro primeiro
Figurino, corpo, pose e enquadramento se resolvem na passada da imagem, porque a passada de vídeo não os muda. Exporte a imagem no formato que quer entregar: não há campo de proporção para corrigir isso depois.
Rascunhe em 480p, entregue de uma vez
Três segundos em 480p custam pouco para testar se um quadro anima bem. Quando animar, gere a duração completa em 720p ou 1080p com o mesmo seed e acrescente o som na edição, porque a faixa que este endpoint devolve muitas vezes vem muda ou baixa demais. Se o preset tuned padrão brigar com o visual que você escreveu, troque preset para original, que quase não aplica estilo.
Adapte o exemplo incluído
O exemplo publicado usa duration_seconds 5 e resolution 720p, com uma única imagem como image_url.
She turns further toward the driver's seat, wet shirt clinging as she moves, pushes a soaked strand of hair back and mouths something with a tired smile. Rain streams down the windscreen, neon reflections crawl across the glass, wipers sweep once.
Uma imagem mais uma nota de movimento: o giro, o cabelo e os limpadores estão escritos, enquanto a camisa molhada e o enquadramento vêm do quadro.
Confira o resultado antes de iterar
O quadro inicial é seguido de perto e as imagens passam como foram enviadas. Se usar prompt, limite-o ao movimento, porque um texto que contradiz o quadro faz o clipe negociar entre os dois. Vinte segundos são uma geração, não um corte: um rascunho de três segundos e uma versão final de vinte são passadas separadas. A resolução padrão é 480p, então peça 720p ou 1080p na entrega.
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.3-spicy/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"preset": "tuned",
"resolution": "480p"
}
}'
# 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.
