Cómo usar la API LTX-2

La API LTX-2 permite a los desarrolladores crear contenido de vídeo atractivo mediante inteligencia artificial. Este servicio, proporcionado por Lightricks, permite a los usuarios transformar descripciones de texto o imágenes estáticas en vídeos sincronizados con audio. Los ingenieros lo integran en aplicaciones para tareas que van desde la creación de contenido hasta la creación de prototipos de efectos visuales. Además, la API admite varios modelos optimizados para la velocidad o la calidad, lo que permite la personalización en función de las necesidades del proyecto.

💡

Para probar y gestionar las solicitudes de forma eficaz, los desarrolladores suelen recurrir a herramientas especializadas. Por ejemplo, Apidog ofrece una interfaz fácil de usar para construir, enviar y depurar llamadas a la API. Maneja sin problemas los encabezados de autenticación, las cargas útiles JSON y el análisis de respuestas.

botón

Por lo tanto, considera descargar Apidog gratis para mejorar tu interacción con la API LTX-2 y centrarte más en la innovación que en la configuración.

¿Qué es la API LTX-2?

Los desarrolladores emplean la API LTX-2 para generar vídeos programáticamente. Este servicio RESTful aprovecha modelos avanzados de IA para producir resultados cinematográficos a partir de entradas simples. Específicamente, ofrece tres capacidades principales: generación de texto a vídeo, transformación de imagen a vídeo y funcionalidad de repetición para editar segmentos de vídeo.

La API se basa en el modelo LTX-2, una base basada en transformadores de difusión (DiT) que crea audio y vídeo sincronizados en una sola pasada. Los usuarios envían prompts, y el sistema renderiza vídeos de hasta 20 segundos de duración, dependiendo del modelo y la configuración seleccionados. Además, soporta altas resoluciones como 4K y velocidades de cuadro de hasta 50 FPS, lo que lo hace adecuado para aplicaciones profesionales.

Lightricks aloja la API, asegurando escalabilidad y fiabilidad. Los usuarios acceden a ella a través de puntos finales HTTPS, con respuestas que entregan archivos MP4 directamente. Este enfoque síncrono simplifica los flujos de trabajo, ya que los desarrolladores reciben el vídeo generado en el cuerpo de la respuesta sin tener que consultar el estado. Sin embargo, se aplican límites de velocidad para evitar la sobrecarga, por lo que los equipos monitorean el uso cuidadosamente.

En comparación con las alternativas de código abierto, la API LTX-2 alojada abstrae los requisitos de hardware. Los desarrolladores evitan gestionar GPU o instalar frameworks como ComfyUI, centrándose en su lugar en la integración. No obstante, para aquellos que prefieren la ejecución local, Lightricks proporciona el modelo LTX-2 de código abierto en GitHub, pero esta guía enfatiza la API para una eficiencia basada en la nube.

Primeros pasos con la API LTX-2

Los usuarios comienzan obteniendo credenciales. Primero, inicie sesión en la Consola de Desarrolladores. La plataforma le guiará a través de la creación de una cuenta si es necesario. Una vez conectado, genere una clave API directamente desde el panel de control.

Esta clave sirve como su token de acceso. Guárdela de forma segura, ya que autentica todas las solicitudes. Por ejemplo, colóquela en variables de entorno para evitar la codificación directa en scripts. En Bash, ejecute export LTXV_API_KEY="your_key_here". Los desarrolladores de Python la recuperan con import os; api_key = os.environ.get("LTXV_API_KEY"). Los usuarios de Node.js acceden a ella a través de process.env.LTXV_API_KEY.

Después de asegurar la clave, pruebe la conectividad con una solicitud simple. Utilice herramientas como curl o Apidog para verificar la configuración. Este paso confirma el estado de su cuenta y le familiariza con el formato de respuesta de la API. Si surgen problemas, verifique errores comunes como claves no válidas, que devuelven un estado 401.

Además, revise los detalles de su plan en la consola. Los diferentes niveles ofrecen créditos y límites variables, lo que influye en la frecuencia con la que genera vídeos. Los equipos actualizan los planes según sea necesario para admitir volúmenes más altos.

¿Cómo autenticar solicitudes en la API LTX-2?

La autenticación protege el acceso a la API. Incluya la clave en el encabezado de autorización de cada solicitud utilizando el formato Bearer. Específicamente, establezca Authorization: Bearer YOUR_API_KEY.

Por ejemplo, un comando curl se ve así:

curl -X POST https://api.ltx.video/v1/text-to-video \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "A serene mountain landscape at dawn", "model": "ltx-2-pro", "duration": 8, "resolution": "1920x1080"}'

Las implementaciones de Python utilizan la biblioteca requests:

import requests
import os

api_key = os.environ.get("LTXV_API_KEY")
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}
payload = {
    "prompt": "A serene mountain landscape at dawn",
    "model": "ltx-2-pro",
    "duration": 8,
    "resolution": "1920x1080"
}
response = requests.post("https://api.ltx.video/v1/text-to-video", headers=headers, json=payload)
if response.status_code == 200:
    with open("video.mp4", "wb") as f:
        f.write(response.content)

Siga diligentemente las prácticas de seguridad. Nunca exponga las claves en el código del lado del cliente o en los repositorios. Rótelas periódicamente a través de la consola. Además, use variables de entorno para el almacenamiento para mejorar la portabilidad.

Si la autenticación falla, la API responde con un 401 No autorizado. El cuerpo incluye detalles como "Invalid API key" (Clave API no válida) o "Missing authorization header" (Encabezado de autorización faltante). Solucione el problema verificando el formato y la caducidad de la clave. Las soluciones comunes implican regenerar la clave o corregir la sintaxis del encabezado.

Entendiendo los modelos soportados en la API LTX-2

La API LTX-2 proporciona dos modelos principales: ltx-2-fast y ltx-2-pro. Cada uno se optimiza para diferentes prioridades.

El modelo ltx-2-fast prioriza la eficiencia. Soporta resoluciones de hasta 3840x2160, FPS de 25 o 50, y duraciones de 6 a 20 segundos en ciertas configuraciones. Por ejemplo, a 1920x1080 y 25 FPS, maneja hasta 20 segundos. Este modelo es adecuado para la creación rápida de prototipos donde la velocidad es más importante que la perfección.

Por el contrario, el modelo ltx-2-pro enfatiza la calidad. Limita las duraciones a 6, 8 o 10 segundos, pero ofrece un detalle y una coherencia superiores. También soporta resoluciones de hasta 3840x2160 y FPS de 25 o 50. Los desarrolladores lo eligen para producciones finales que requieren un acabado pulcro.

Consulte esta matriz de soporte de modelos para combinaciones precisas:

Modelo	Resolución	FPS	Duración (segundos)
ltx-2-fast	1920x1080	25	6, 8, 10, 12, 14, 16, 18, 20
	1920x1080	50	6, 8, 10
	2560x1440	25, 50	6, 8, 10
	3840x2160	25, 50	6, 8, 10
ltx-2-pro	1920x1080	25, 50	6, 8, 10
	2560x1440	25, 50	6, 8, 10
	3840x2160	25, 50	6, 8, 10

Seleccione modelos según los requisitos. Por ejemplo, use ltx-2-fast durante las iteraciones de desarrollo, luego cambie a ltx-2-pro para producción. Tenga en cuenta que resoluciones y duraciones más altas consumen más créditos.

Dominando el endpoint de texto a vídeo en la API LTX-2

Los desarrolladores invocan el endpoint de texto a vídeo para crear vídeos a partir de descripciones. La URL es https://api.ltx.video/v1/text-to-video, utilizando el método POST.

Los parámetros requeridos incluyen:

prompt: String, hasta 5000 caracteres, describiendo la escena.
model: Enum, "ltx-2-fast" o "ltx-2-pro".
duration: Entero, en segundos, según las restricciones del modelo.
resolution: String, como "1920x1080".

Los parámetros opcionales mejoran el control:

fps: Entero, por defecto 25.
camera_motion: Enum para efectos como paneo o zoom (valores específicos no detallados aquí, consulte la documentación).
generate_audio: Booleano, por defecto true para audio sincronizado.

La solicitud espera contenido JSON. Las respuestas exitosas devuelven un archivo MP4 en el cuerpo, con Content-Type: video/mp4.

Por ejemplo, genere un vídeo de 8 segundos:

curl -X POST https://api.ltx.video/v1/text-to-video \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "A majestic eagle soaring through clouds at sunset", "model": "ltx-2-pro", "duration": 8, "resolution": "1920x1080"}' \
-o video.mp4

El equivalente en Python guarda el archivo directamente. Si ocurren errores, maneje códigos como 400 para parámetros no válidos o 429 para límites.

Experimente con los prompts para refinar los resultados. Incluya detalles sobre la acción, los personajes y el audio para obtener mejores resultados. Este endpoint forma la base para la creación de vídeos basados en texto.

Explorando el endpoint de imagen a vídeo en la API LTX-2

El endpoint de imagen a vídeo anima imágenes estáticas. Utiliza POST a https://api.ltx.video/v1/image-to-video.

Los parámetros clave son similares a los de texto a vídeo, pero añaden image_uri: String, una URL a la imagen de entrada (HTTPS, hasta 32 MB, formatos como JPG).

Ejemplo de solicitud:

curl -X POST https://api.ltx.video/v1/image-to-video \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"image_uri": "https://example.com/sunset.jpg", "prompt": "Clouds drifting across the sky as the sun sets slowly", "model": "ltx-2-pro", "duration": 8, "resolution": "1920x1080"}' \
-o video.mp4

Las respuestas entregan el MP4 animado. Utilícelo para dar vida a las fotos, como en aplicaciones de marketing o educación. Asegúrese de que las imágenes se alineen con los prompts para un movimiento coherente.

Las restricciones coinciden con los modelos: valide la duración y la resolución. Si la recuperación de la imagen falla, espere errores 400.

Utilizando la función de repetición (Retake) en la API LTX-2

La capacidad de repetición edita secciones de vídeo sin una regeneración completa. Se dirige a momentos específicos, reemplazando audio, vídeo o ambos a través de IA.

Aunque las especificaciones detalladas del endpoint están evolucionando, es probable que use POST a una ruta como /v1/retake. Los parámetros incluyen video_uri para el original, start_time y end_time en segundos, y prompt para los cambios.

Por ejemplo, reescribir un segmento de diálogo. Esto ahorra recursos en comparación con la recreación de vídeos completos. Los desarrolladores lo aplican para refinamientos iterativos en flujos de trabajo de postproducción.

Monitoree las actualizaciones en la documentación para obtener todos los parámetros. Actualmente, reescribe los momentos de manera eficiente, manteniendo la sincronización.

Manejo de errores en la API LTX-2

La API estandariza las respuestas de error:

{
  "type": "error",
  "error": {
    "type": "error_type",
    "message": "Description"
  }
}

Códigos comunes:

400: Solicitud inválida, p. ej., prompt faltante.
401: Problema de autenticación.
402: Créditos insuficientes.
413: Carga útil demasiado grande.
422: Contenido filtrado.
429: Límite de tasa o concurrencia.
500: Error del servidor.
503: No disponible.

Maneje con gracia: Reintente en caso de 429 con el encabezado Retry-After. Verifique los saldos para 402. Registre mensajes para depuración.

Mejores prácticas: Valide las entradas en el lado del cliente, implemente un retroceso exponencial para los reintentos.

Gestión de límites de tasa en la API LTX-2

Los límites de tasa previenen el abuso. Incluyen concurrencia (solicitudes simultáneas) y tasa (solicitudes por ventana), variando según el plan.

Exceder los límites dispara un 429 con Retry-After. Tipos de error: rate_limit_error o concurrency_limit_error.

Monitoree a través de los encabezados. Optimice agrupando donde sea posible, utilizando resoluciones más bajas para las pruebas y actualizando los planes.

Contacte al soporte para aumentos.

Mejores prácticas para integrar la API LTX-2

Implemente un manejo de errores y registro robustos. Utilice procesamiento asíncrono si escala.

Proteja las claves con bóvedas. Pruebe los prompts exhaustivamente.

Para producción, calcule los costos: los vídeos más largos usan más créditos.

Integre con los flujos de trabajo: Genere miniaturas a partir de imágenes, luego vídeos completos.

Uso de Apidog con la API LTX-2

Apidog agiliza las pruebas. Importe endpoints, configure encabezados y envíe solicitudes visualmente.

Cree colecciones para llamadas a la API LTX-2. Depure respuestas, incluyendo MP4 binarios.

Soporta entornos para claves, facilitando los cambios.

Descargue Apidog gratis para aumentar la productividad.

Ejemplos avanzados con la API LTX-2

En Python, cree un wrapper:

import requests
import os

class LTX2API:
    def __init__(self):
        self.api_key = os.environ.get("LTXV_API_KEY")
        self.base_url = "https://api.ltx.video/v1"

    def generate_text_to_video(self, prompt, model="ltx-2-pro", duration=8, resolution="1920x1080"):
        headers = {"Authorization": f"Bearer {self.api_key}", "Content-Type": "application/json"}
        payload = {"prompt": prompt, "model": model, "duration": duration, "resolution": resolution}
        response = requests.post(f"{self.base_url}/text-to-video", headers=headers, json=payload)
        if response.status_code == 200:
            return response.content
        else:
            raise Exception(response.json()["error"]["message"])

# Uso
api = LTX2API()
video_data = api.generate_text_to_video("A futuristic cityscape at night")
with open("output.mp4", "wb") as f:
    f.write(video_data)

Extienda para imagen a vídeo. Úselo en aplicaciones web a través de Flask o Django.

Conclusión

La API LTX-2 transforma la creación de vídeo. Siguiendo esta guía, los desarrolladores aprovechan su poder de manera efectiva. Comience con lo básico, refine los prompts y escale las integraciones. Herramientas como Apidog simplifican el proceso, asegurando un desarrollo fluido.

botón