Referência para desenvolvedores LTX-2

Documentação da API LTX-2

Crie tarefas assíncronas de texto ou imagem para vídeo e consulte o ID retornado até o vídeo ficar pronto.

URL basehttps://ltx-2ai.com

Autenticação

Envie a chave de API como Bearer Token. Inclua Content-Type: application/json ao enviar um corpo JSON.

HTTP headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

A geração é assíncrona. Consulte status a cada 5-10 segundos; intervalos menores não aceleram a tarefa.

Criar tarefa de vídeo

POSThttps://ltx-2ai.com/api/video/ltx-2/generate

Cria uma tarefa LTX-2 e retorna task_id imediatamente. Esta referência cobre texto e imagem para vídeo.

Modos de geração

Texto para vídeo

Envie prompt sem image. aspect_ratio controla o enquadramento de saída.

Imagem para vídeo

Envie prompt e uma URL pública de imagem. A imagem de entrada determina a proporção.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
type	string	Não	Opcional: text-to-video ou image-to-video. Se image for enviado, image-to-video será usado.
prompt	string	Sim	Descrição do vídeo, 3-2000 caracteres. Obrigatória nos dois modos.
image	string	Não	URL pública da imagem. Obrigatória para image-to-video; image_url e imageUrl também são aceitos.
resolution	string	Não	480p, 720p ou 1080p. Padrão: 720p.
aspect_ratio	string	Não	16:9 ou 9:16 para text-to-video. Padrão: 16:9.
duration	integer	Não	Duração de 5 a 20 segundos. Padrão: 5.
seed	integer	Não	Semente aleatória. Use -1 para resultado aleatório.
public	boolean	Não	Se a tarefa pode aparecer em galerias públicas.

Exemplo de solicitação

cURL

curl --request POST \
  --url https://ltx-2ai.com/api/video/ltx-2/generate \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "image-to-video",
    "prompt": "The subject turns toward the camera and smiles naturally",
    "image": "https://example.com/input.jpg",
    "resolution": "720p",
    "duration": 5,
    "seed": -1
  }'

Exemplo de resposta

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n50abc123def456ltx2",
    "status": "IN_PROGRESS",
    "consumed_credits": 24
  }
}

Consultar status

GEThttps://ltx-2ai.com/api/video/ltx-2/status

Envie task_id como query GET. POST com JSON também é aceito. Continue consultando enquanto estiver IN_PROGRESS.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
task_id	string	Sim	ID da tarefa retornado pelo endpoint generate.

Exemplo de solicitação

cURL

curl --request GET \
  --url 'https://ltx-2ai.com/api/video/ltx-2/status?task_id=n50abc123def456ltx2' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Exemplo de resposta

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n50abc123def456ltx2",
    "status": "SUCCESS",
    "consumed_credits": 24,
    "error_message": null,
    "created_at": "2026-08-07T12:00:00Z",
    "request": {
      "type": "image-to-video",
      "prompt": "The subject turns toward the camera and smiles naturally",
      "image": "https://example.com/input.jpg",
      "resolution": "720p",
      "duration": 5
    },
    "response": [
      "https://cdn.example.com/video.mp4"
    ]
  }
}

Valores de status

IN_PROGRESS

O vídeo está na fila ou renderizando. Continue consultando.

SUCCESS

A geração terminou. O array response contém a URL do vídeo.

FAILED

A geração falhou. Consulte error_message; os créditos descontados são reembolsados.

Respostas de erro

HTTP	Descrição
400	Um parâmetro obrigatório está ausente ou é inválido.
401	A chave de API Bearer está ausente ou é inválida.
404	Não existe tarefa para o task_id informado.
405	O método HTTP não é aceito por este endpoint.
500	Erro temporário de geração ou status. Tente novamente mais tarde ou contate o suporte.