Une API de compositeur vidéo IA devrait faire plus que de simplement renvoyer un clip généré. Le flux de travail pratique est: choisir un format vidéo, générer un plan éditable, laisser l’application ou l’utilisateur réviser le storyboard, afficher la vidéo finale, puis faire un rapport sur l’utilisation d’une manière que les équipes finance et produit puissent comprendre.
EmpirioLabs Compose expose ce flux à travers /v1/videos/compose.
1. Lister les recettes disponibles
Les recettes sont des définitions publiques au format. Chaque recette indique le slug, le nom affiché, la description, les entrées prises en charge, les limites de scène, les valeurs par défaut des sous-titres et les modèles recommandés.
curl https://api.empiriolabs.ai/v1/videos/compose/recipes \ -H « Autorisation: Porteur $EMPIRIO_API_KEY »2. Créer un plan modifiable
Utilisation mode: « plan » Quand vous voulez un storyboard avant de rendu. La réponse est un identifiant de poste. Sondage /v1/jobs/{job_id} jusqu’à ce que le statut du poste soit Successeur.
{ « recette »: « ai-ugc-product-ad », « mode »: « plan », « bref »: « Un créateur explique une tasse de voyage qui garde le café chaud toute la matinée », « product_image »: « https://example.com/mug.jpg" }Le résultat réussi du plan comprend la narration de la scène, le texte des légendes, des invitations visuelles, des choix de modèles et des aides aux sous-titres sociaux lorsque cela est soutenu.
3. Rendre la vidéo finale
Rendez-moi le storyboard avec mode: « render ». Vous pouvez d’abord modifier la copie de la scène, les légendes et les invites visuels, ou afficher le plan tel quel.
{ « recette »: « ai-ugc-product-ad », « mode »: « render », « storyboard »: { « titre »: « Mug de voyage », « scènes »: [] } }Le travail de rendu renvoie l’URL MP4 finale une fois terminé. Les applications clientes doivent traiter Compose comme asynchrone, car une production complète inclut plusieurs appels de modèle et une étape finale de rendu.
4. Audit des dépenses et de l’utilisation
Utilisez l’API d’utilisation des comptes pour extraire les enregistrements uniquement Compose:
curl « https://platform.empiriolabs.ai/api/v1/account/usage?source=compose&limit=25" \ -H « Autorisation: Porteur $EMPIRIO_API_KEY »Le résumé comprend spend.compose, et chaque événement d’utilisation peut inclure des métadonnées Compose telles que le slug de la recette, la phase et le nombre de sorties. Cela permet de garder des rapports propres lorsqu’un produit utilise des appels de modèles normaux et des tâches Compose vidéo complète côte à côte.
Référence complète
Lisez le guide complet de l’API à Compose docs et la référence de rapport à API d’utilisation des comptes.
