Uma API de compositor de vídeo com IA deve fazer mais do que devolver um clipe gerado. O fluxo prático é: escolha um formato de vídeo, gere um plano editável, deixe o aplicativo ou usuário revisar o storyboard, renderize o vídeo final e depois reporte o uso de uma forma que as equipes financeira e de produto possam entender.
EmpirioLabs Compose expõe esse fluxo através /v1/videos/compose.
1. Lista de receitas disponíveis
Receitas são definições de formato público. Cada receita informa o slug, nome de exibição, descrição, entradas suportadas, limites de cena, padrões de legendas e modelos recomendados.
curl https://api.empiriolabs.ai/v1/videos/compose/recipes \ -H "Autorização: Portador $EMPIRIO_API_KEY"2. Crie um plano editável
Uso Modo: "Plano" Quando você quer um storyboard antes de renderizar. A resposta é um ID de emprego. Enquete /v1/jobs/{job_id} até que o status do cargo seja Sucedeu.
{ "receita": "ai-ugc-product-ad", "mode": "plan", "brief": "Um criador explica uma caneca de viagem que mantém o café quente a manhã toda", "product_image": "https://example.com/mug.jpg" }O resultado bem-sucedido do plano inclui narração de cenas, texto das legendas, prompts visuais, escolhas de modelos e auxiliares para legendas sociais quando forem apoiados.
3. Renderizar o vídeo final
Passe o storyboard de volta com Modo: "renderizar". Você pode editar a cópia da cena, legendas e prompts visuais primeiro, ou renderizar o plano como retornou.
{ "receita": "ai-ugc-product-ad", "mode": "render", "storyboard": { "título": "Travel Mug UGC", "cenas": [] } }O trabalho de renderização retorna a URL final do MP4 quando concluído. Aplicativos clientes devem tratar o Compose como assíncrono, pois uma produção completa inclui várias chamadas de modelo e uma etapa final de renderização.
4. Auditoria de gastos e uso
Use a API de uso de contas para puxar registros apenas do Compose:
curl "https://platform.empiriolabs.ai/api/v1/account/usage?source=compose&limit=25" \ -H "Autorização: Portador $EMPIRIO_API_KEY"O resumo inclui spend.compose, e cada evento de uso pode incluir metadados do Compose, como slug da receita, fase e contagem de saída. Isso mantém os relatórios limpos quando um produto usa chamadas normais de modelo e trabalhos de composição em vídeo completo lado a lado.
Referência completa
Leia o guia completo da API em Compor documentação e a referência de relatório em API de Uso de Contas.
