Por enquanto este guia está só em inglês. →
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
duration_seconds | Não | Quanto tempo dura o clipe. Cobrado por segundo. ≥ 5 · ≤ 20 · Padrão: 5 |
image_url | Sim | A imagem de partida. |
loras | Não | Carregue seus arquivos LoRA para fixar um estilo ou personagem. Padrão: [] |
prompt | Sim | Describe what happens after the opening frame: the action, the camera and the sound. |
resolution | Não | Tamanho de saída. Maior fica mais nítido e custa mais. 480p · 720p · 1080p · Padrão: 720p |
seed | Não | Repetir o mesmo número dá um resultado reproduzível. ≥ 0 · ≤ 2147483647 |
Preços
Os preços são em créditos, os mesmos que você usa no site (1 crédito = US$ 0,01). O valor é reservado quando a tarefa é aceita e acertado pelo custo real quando ela termina; tarefas com falha são reembolsadas.
| Opção | Créditos por segundo | ≈ USD |
|---|---|---|
| resolution 480p | 2,7 | US$ 0,027 |
| resolution 720p | 3,6 | US$ 0,036 |
| resolution 1080p | 5,4 | US$ 0,054 |
Cada tarefa é arredondada para cima em créditos inteiros, então uma execução no nível mais baixo custa 14 créditos por um clipe de 5 segundos (US$ 0,14).
Para saber o valor exato antes de rodar, envie o mesmo corpo para POST /jobs/quote.
Início rápido da API
Chame a API do LTX-2 19B LoRA em três passos
- Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow- e usam os mesmos créditos do site.
- Envie a requisição. Faça POST /jobs/createTask com model lightricks/ltx-2-19b-lora/image-to-video e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
- Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "lightricks/ltx-2-19b-lora/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "720p",
"duration_seconds": 5
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.
Perguntas sobre a API do LTX-2 19B LoRA
Quanto custa a API do LTX-2 19B LoRA?
O LTX-2 19B LoRA custa a partir de 14 créditos (US$ 0,14) por um clipe de 5 segundos com Imagem para vídeo, a tarefa mais barata. Preços por opção: 480p 2,7 créditos por segundo, 720p 3,6 créditos por segundo, 1080p 5,4 créditos por segundo. Os créditos são os mesmos do site (1 crédito = US$ 0,01), contas novas ganham 30 créditos grátis e tarefas que falham são reembolsadas.
Qual é o nome de modelo do LTX-2 19B LoRA na API?
Coloque lightricks/ltx-2-19b-lora/text-to-video para Criar vídeo; lightricks/ltx-2-19b-lora/image-to-video para Imagem para vídeo no campo model de POST /jobs/createTask.
Quais LoRAs funcionam aqui?
Arquivos treinados para o LTX-2 19B, como os LoRAs de controle de câmera que a Lightricks publica para ele e os LoRAs da comunidade listados nesse modelo base no Hugging Face. LoRAs para LTX 2.3, Wan, HunyuanVideo ou modelos de imagem não se transferem.
Meu LoRA carregou, mas nada mudou. Por quê?
Provavelmente ele foi treinado para outro modelo base. No nosso teste, um LoRA do Wan carregou sem erro e o clipe ficou igual à execução sem LoRA. Alguns LoRAs também precisam das palavras-gatilho no prompt.
Qual scale devo usar?
LoRAs de câmera em 1. Para LoRAs de estilo, comece em 0,5: no nosso teste, 0,5 já deu um estilo claro e 1 também mudou o cenário e os personagens.
Posso empilhar LoRAs?
Sim, até três. Um LoRA de estilo junto com um LoRA de câmera funcionou no nosso teste, e o estilo se manteve.
Tem som?
Sim. Todo clipe tem uma trilha sonora estéreo gerada junto com a imagem; descreva-a em uma linha "Audio:".
Quais são os limites da API do LTX-2 19B LoRA?
Duração do clipe: 5–20 s; Resoluções: 480p · 720p · 1080p. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.
Dá para testar o LTX-2 19B LoRA sem escrever código?
Dá. O Playground roda o LTX-2 19B LoRA com seus créditos da PopNow, não precisa de chave de API e mostra o código de cada geração.
Todos os modelos LTX
O LTX-2.3 LoRA roda o modelo mais novo, de 22 bilhões de parâmetros; escolha aquele para o qual o seu LoRA foi treinado.
- API do LTX 2.5Tomadas longas de 20 segundos até 4K, com trilha sonoraA partir de 68 créditos por um clipe de 5 segundos
- API do LTX-2.3 LoRAClipes LTX-2.3 com som estéreo e seus próprios LoRAsA partir de 18 créditos por um clipe de 5 segundos
- API do LTX-2 19BClipes de 20 segundos com vozes, música e efeitosA partir de 11 créditos por um clipe de 5 segundos
- API do LTX-2 19B LoRAClipes LTX-2 com som e seus próprios estilos de LoRAA partir de 14 créditos por um clipe de 5 segundos

