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.
