Inicio Blog

Cómo llamar a una API de compositores de vídeo con IA

Portada del blog API para compositores de vídeo con IA

Jun 26, 2026

EmpirioLabs AI

Divulgación: Este artículo se escribió con ayuda de IA y fue revisado por EmpirioLabs AI.

Una API de compositor de vídeo con IA debería hacer más que devolver un solo clip generado. El flujo de trabajo práctico es: elegir un formato de vídeo, generar un plan editable, dejar que la app o el usuario revise el storyboard, renderizar el vídeo final y luego informar el uso de forma que los equipos de finanzas y producto puedan entender.

EmpirioLabs Compose expone ese fluir a través de eso /v1/videos/compose.

1. Lista de recetas disponibles

Las recetas son definiciones de formato público. Cada receta te indica el slug, nombre visual, descripción, entradas compatibles, límites de escena, valores predeterminados de los subtítulos y modelos recomendados.

curl https://api.empiriolabs.ai/v1/videos/compose/recipes \ -H "Autorización: Portador $EMPIRIO_API_KEY"

2. Crear un plan editable

Uso modo: "plan" Cuando quieras un storyboard antes de renderizar. La respuesta es un identificador de trabajo. Encuesta /v1/jobs/{job_id} hasta que el estado del trabajo sea sucedió.

{ "receta": "ai-ugc-product-ad", "mode": "plan", "brief": "Un creador explica una taza de viaje que mantiene el café caliente toda la mañana", "product_image": "https://example.com/mug.jpg" }

El resultado exitoso del plan incluye narración de escenas, texto de los pies de foto, indicaciones visuales, elecciones de modelos y ayudas para los subtítulos sociales cuando se apoyan.

3. Renderizar el vídeo final

Devuélveme el storyboard con modo: "render". Puedes editar primero el texto de la escena, los pies de foto y las indicaciones visuales, o renderizar el plano tal y como se ha devuelto.

{ "receta": "ai-ugc-product-ad", "modo": "render", "storyboard": { "título": "Travel Mug UGC", "escenas": [] } }

El trabajo de renderizado devuelve la URL final de MP4 cuando está terminado. Las aplicaciones cliente deberían tratar Compose como asincrónico, porque una producción completa incluye varias llamadas al modelo y un paso final de renderizado.

4. Auditoría del gasto y uso

Utiliza la API de uso de cuentas para obtener registros exclusivos de Compose:

curl "https://platform.empiriolabs.ai/api/v1/account/usage?source=compose&limit=25" \ -H "Autorización: Portador $EMPIRIO_API_KEY"

El resumen incluye spend.compose, y cada evento de uso puede incluir metadatos de Compose como slug de receta, fase y recuento de salida. Esto mantiene los informes limpios cuando un producto utiliza llamadas normales de modelo y trabajos de composición en vídeo completo lado a lado.

Referencia completa

Lee la guía completa de la API en Compone docs y la referencia de informe en API de Uso de Cuentas.

¿Listo para usar mejores endpoints?

Explora nuestros modelos o contáctanos para consultas empresariales, despliegues personalizados o cualquier otra cosa.