Referencia para desarrolladores de LTX-2

Documentación de la API LTX-2

Crea tareas asíncronas de texto o imagen a vídeo y consulta el ID devuelto hasta que el vídeo esté listo.

URL basehttps://ltx-2ai.com

Autenticación

Envía la clave API como Bearer Token. Añade Content-Type: application/json al enviar un cuerpo JSON.

HTTP headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

La generación es asíncrona. Consulta status cada 5-10 segundos; intervalos menores no aceleran la tarea.

Crear una tarea de vídeo

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

Crea una tarea LTX-2 y devuelve task_id de inmediato. Esta referencia cubre texto a vídeo e imagen a vídeo.

Modos de generación

Texto a vídeo

Envía prompt sin image. aspect_ratio controla el formato de salida.

Imagen a vídeo

Envía prompt y una URL de imagen pública. La imagen de entrada determina la relación de aspecto.

Parámetros

Nombre	Tipo	Obligatorio	Descripción
type	string	No	Opcional: text-to-video o image-to-video. Si se proporciona image, se usa image-to-video.
prompt	string	Sí	Descripción del vídeo, de 3 a 2000 caracteres. Obligatoria en ambos modos.
image	string	No	URL de imagen pública. Obligatoria para image-to-video; también se aceptan image_url e imageUrl.
resolution	string	No	480p, 720p o 1080p. Predeterminado: 720p.
aspect_ratio	string	No	16:9 o 9:16 para text-to-video. Predeterminado: 16:9.
duration	integer	No	Duración de 5 a 20 segundos. Predeterminado: 5.
seed	integer	No	Semilla aleatoria. Usa -1 para un resultado aleatorio.
public	boolean	No	Indica si la tarea puede aparecer en galerías públicas.

Ejemplo de solicitud

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
  }'

Ejemplo de respuesta

200 OK

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

Consultar estado

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

Envía task_id como query GET. También se admite POST con JSON. Sigue consultando mientras esté IN_PROGRESS.

Parámetros

Nombre	Tipo	Obligatorio	Descripción
task_id	string	Sí	ID de tarea devuelto por el endpoint generate.

Ejemplo de solicitud

cURL

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

Ejemplo de respuesta

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 estado

IN_PROGRESS

El vídeo está en cola o renderizándose. Sigue consultando.

SUCCESS

La generación terminó. El array response contiene la URL del vídeo.

FAILED

La generación falló. Revisa error_message; los créditos descontados se reembolsan.

Respuestas de error

HTTP	Descripción
400	Falta un parámetro obligatorio o no es válido.
401	Falta la clave API Bearer o no es válida.
404	No existe una tarea para el task_id indicado.
405	El método HTTP no está permitido en este endpoint.
500	Error temporal de generación o estado. Reintenta más tarde o contacta con soporte.