Eine KI-Videokomponist-API sollte mehr tun, als nur einen generierten Clip zurückzugeben. Der praktische Arbeitsablauf ist: Ein Videoformat auswählen, einen bearbeitbaren Plan erstellen, die App oder den Nutzer das Storyboard überarbeiten lassen, das endgültige Video rendern und dann die Nutzung so berichten, dass Finanz- und Produktteams es verstehen können.
EmpirioLabs Compose legt diesen Fluss frei /v1/videos/compose.
1. Liste verfügbare Rezepte auf
Rezepte sind Definitionen im öffentlichen Format. Jedes Rezept zeigt dir den Slug, den Anzeigenamen, die Beschreibung, unterstützte Eingaben, Szenenbegrenzungen, Bildunterschriften-Standardeinstellungen und empfohlene Modelle an.
curl https://api.empiriolabs.ai/v1/videos/compose/recipes \ -H "Autorisierung: Träger $EMPIRIO_API_KEY"2. Erstellen Sie einen bearbeitbaren Plan
Verwendung Modus: "Plan" Wenn du vor dem Rendern ein Storyboard möchtest. Die Antwort ist eine Job-ID. Umfrage /v1/jobs/{job_id} Bis der Jobstatus lautet erfolgreich.
{ "rezept": "ai-ugc-product-ad", "mode": "plan", "brief": "Ein Schöpfer erklärt eine Reisetasse, die Kaffee den ganzen Morgen heiß hält", "product_image": "https://example.com/mug.jpg" }Das erfolgreiche Planergebnis umfasst Szenenerzählung, Bildunterschriftentexte, visuelle Hinweise, Modellwahl und soziale Unterschriftenhilfen, sofern unterstützt.
3. Das endgültige Video rendern
Gib das Storyboard zurück mit Modus: "Rendern". Du kannst zuerst Szenenkopien, Bildunterschriften und visuelle Eingaben bearbeiten oder den Plan als zurückgegeben rendern.
{ "rezept": "ai-ugc-product-ad", "mode": "render", "storyboard": { "title": "Travel Mug UGC", "scenes": [] } }Der Renderjob liefert nach Abschluss die finale MP4-URL zurück. Client-Apps sollten Compose als asynchron behandeln, da eine vollständige Produktion mehrere Modellaufrufe und einen letzten Render-Schritt umfasst.
4. Ausgaben und Nutzung der Prüfung
Verwenden Sie die Account Use API, um nur Compose-Datensätze abzurufen:
curl "https://platform.empiriolabs.ai/api/v1/account/usage?source=compose&limit=25" \ -H "Autorisierung: Träger $EMPIRIO_API_KEY"Die Zusammenfassung umfasst spend.compose, und jedes Nutzungsereignis kann Compose-Metadaten wie Rezept-Slug, Phase und Ausgabeanzahl enthalten. Das hält die Meldung sauber, wenn ein Produkt normale Modellaufrufe und vollständige Video-Compose-Aufträge nebeneinander verwendet.
Vollständige Referenz
Lesen Sie den vollständigen API-Leitfaden unter Compose Docs und die Berichtsreferenz bei Kontonutzungs-API.
