Lightricks

LTX 2.5 Fast

ltx-2.5-fast/text-to-video

Modelo de generación de vídeo acelerado de Lightricks, compatible con texto a vídeo e imagen a vídeo, con generación sincronizada de imagen y audio, ideal para producir vídeos rápidamente y validar prototipos

ltx-2.5-fast/image-to-video ltx-2.5-fast/text-to-video

Probar ltx-2.5-fast/text-to-video

Entrada

Creaciones

Ver todas las creaciones

Salida

video

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

ltx-2.5-fast/text-to-video per second

Especificaciones	Precio unitario
1080P	$0.086

Descripción general

ltx-2.5-fast/text-to-video es la vía acelerada de texto a vídeo de la familia de generación de vídeo LTX-2.5 de Lightricks, invocable a través de la interfaz unificada de HiAPI.ai. Basta con introducir un prompt que describa la imagen, el movimiento, el encuadre y el sonido para obtener un clip de vídeo con audio nativo. La duración se puede seleccionar en segundos, la salida admite 720p y 1080p, y el formato cubre tanto horizontal como vertical. Es adecuada para desarrolladores y equipos de contenido que necesitan validar rápidamente la dirección de un plano con una salida veloz y generar material de vídeo corto en lote a alta frecuencia.

Puntos clave

Vía acelerada priorizando la velocidad: posicionada como la versión acelerada de la familia LTX-2.5, enfocada en una salida rápida, ideal para el ensayo y error repetido en la fase de prototipo y la producción en lote de alta frecuencia.
Imagen y audio generados de una vez: genera el vídeo y, al mismo tiempo, produce audio nativo, sin necesidad de procesar por separado el doblaje o los efectos de sonido.
Duración y formato a elección: la duración se puede seleccionar segundo a segundo entre 2 y 20 segundos, con soporte para los formatos 16:9 horizontal y 9:16 vertical.

Descripción de capacidades

Vídeo directo desde el prompt: con un solo prompt que describa la escena, el movimiento, el encuadre y el sonido, el modelo devuelve directamente el archivo de vídeo, eliminando los pasos intermedios de storyboard y producción fotograma a fotograma.

Control de duración por segundos: la duración se puede ajustar en segundos enteros entre 2 y 20 segundos, con 6 segundos por defecto, lo que facilita controlar con precisión la longitud del clip según las especificaciones de publicación en la plataforma o el ritmo del plano.

Resolución y formato seleccionables: la salida admite 720p y 1080p, y ofrece 16:9 horizontal y 9:16 vertical; un mismo prompt puede generar contenidos adaptados a distintas ubicaciones de visualización.

Interruptor de audio sincronizado: mediante parámetros se puede decidir si se genera audio nativo junto con el vídeo, activado por defecto; cuando no se necesita sonido, se puede desactivar para simplificar el flujo de montaje posterior.

Casos de uso

Validación rápida de la dirección de plano por equipos creativos: probar en lote con prompts breves el estilo de plano y la dirección de composición, usando los clips de corta duración generados como muestras de selección antes de decidir si continuar ampliando la producción.
Material de vídeo corto vertical para gestión de redes sociales: generar material en formato 9:16 y con duración corta, directamente utilizable en plataformas de vídeo corto, anuncios en feed y otras ubicaciones de publicación vertical.
Producción en lote de anuncios y contenidos: generar múltiples clips con audio variando una plantilla de prompt unificada, para pruebas de múltiples versiones de material de una misma campaña y producción masiva.
Previsualización previa en cine y animación: convertir las descripciones textuales de la fase de storyboard en clips de referencia dinámicos con sonido, para que arte y montaje evalúen el ritmo y la atmósfera antes de la producción formal.

Limitaciones y recomendaciones de selección

El posicionamiento acelerado implica un compromiso entre velocidad y especificaciones de imagen; no conviene buscar a la vez duraciones muy largas y alta resolución: esta vía tiene un límite de resolución de 1080p, un límite de duración de 20 segundos y solo ofrece los formatos 16:9 y 9:16. Para piezas finales que requieran mayor definición o un control de calidad de imagen más fino, conviene evaluar la versión Pro de la misma familia o la vía de imagen a vídeo; esta vía es más adecuada para necesidades de validación de prototipos y producción masiva.

Preguntas frecuentes

Ver todas las preguntas →

¿Qué resoluciones admite LTX 2.5 Fast?

Dos niveles: 720p y 1080p; el valor predeterminado es 720p. Es igual tanto para texto a vídeo como para imagen a vídeo.
¿Qué duración puede tener el vídeo generado?

De 2 a 20 segundos; opciones de 2, 3, 4, 5, 6, 8, 10, 12, 14, 16, 18 y 20 segundos, con 6 segundos por defecto.
¿Admite orientación vertical?

Sí. Basta con establecer aspect_ratio en 9:16 para obtener un vídeo vertical; el valor predeterminado es 16:9 horizontal.
¿Qué es el audio nativo? ¿Tiene un costo adicional?

Al activar generate_audio, el modelo genera simultáneamente sonido ambiente, efectos de sonido o música de fondo; está activado por defecto. Si se desactiva, se obtiene un video sin sonido y el precio no cambia.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: ltx-2.5-fast/text-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para ltx-2.5-fast/text-to-video y la ruta default; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 1maxLength 5000

Texto de indicación que describe la escena del video a generar, el movimiento de la imagen, el movimiento de cámara y el contenido de audio.

durationintegerOpcionalPredeterminado: 6min 2max 20

Duración del video, en segundos. Valor predeterminado: 6 segundos.

Opciones:2345681012

Mostrar todo (4)

14161820

resolutionstringOpcionalPredeterminado: "720p"

Resolución del video de salida. Valor predeterminado: 720p.

Opciones:720p1080p

aspect_ratiostringOpcionalPredeterminado: "16:9"

Relación de aspecto de la imagen de salida, utilizada para controlar la salida horizontal o vertical. Valor predeterminado: 16:9.

Opciones:16:99:16

generate_audiobooleanOpcionalPredeterminado: true

Indica si se genera audio nativo junto con el video. Valor predeterminado: true.

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ltx-2.5-fast/text-to-video",
  "input": {
    "prompt": "…",
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "ltx-2.5-fast/text-to-video",
    input: {
      "prompt": "…",
      "duration": 6,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "ltx-2.5-fast/text-to-video",
        "input": {
          "prompt": "…",
          "duration": 6,
          "resolution": "720p",
          "aspect_ratio": "16:9",
          "generate_audio": True
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}