Videos mit der API automatisieren

Eine REST-API unter /api/v1, authentifiziert mit einem API-Schlüssel, den Sie in Ihrem Konto erstellen. Sie deckt die gleichen Bereiche ab wie der Rest des Produkts:

• Videos — Erstellen Sie ein Rendering aus einer URL und einem Brief, lesen Sie dessen Status, rufen Sie die fertige MP4 ab.
• Sites — Untersuchen Sie eine Domain, erhalten Sie einen Plan, welche Seiten ein Video verdienen, generieren Sie diese.
• Characters and captures — Die wiederverwendbaren Assets, die eine Serie teilt.
• Shows — Wiederkehrende Episoden, die von einem Feed gesteuert werden.
• Connections — Registrieren Sie eine MCP- oder HTTP-Quelle, aus der ein Format Daten abrufen kann.

Es handelt sich um eine Pro-Funktion, die ab $49 pro Monat enthalten ist. Der Schlüssel ist auf Ihr Konto und Ihr Guthaben beschränkt; es gibt keine separate API-Preisgestaltung.

Das Rendering ist asynchron, und jede Integration muss darauf ausgelegt sein.

1. 1Erstellen. Posten Sie die URL, den Brief, das Seitenverhältnis und etwaige Budgetobergrenzen. Sie erhalten sofort eine ID zurück – das Rendering hat noch nicht einmal begonnen, geschweige denn ist es abgeschlossen.
2. 2Abfragen. Fragen Sie den Status ab. Sie erhalten die Phase, den Fortschritt und eine Schätzung, die basierend auf der tatsächlichen Laufzeit dieses speziellen Renderings neu berechnet wird, anstatt eines Durchschnitts.
3. 3Ergebnis lesen. Wenn es fertig ist, erhalten Sie die MP4 – und die Warnungen.
4. 4Warnungen prüfen. Ein Rendering kann abgeschlossen sein und trotzdem unvollständig sein, und der Status lautet in beiden Fällen done. Eine automatisierte Pipeline, die Warnungen ignoriert, veröffentlicht Filme mit Lücken.

Planen Sie mehrere Minuten pro Rendering ein, mehr, wenn es Clips generiert. Halten Sie keine HTTP-Anfrage offen, um darauf zu warten.

• Katalogvideo. Ein Video pro Produktseite, bei Veröffentlichung generiert, auf der Seite eingebettet. Die wertvollste Automatisierung, da sie auf Seiten angewendet wird, die bereits Traffic erhalten.
• Release Notes als Video. Ein Film pro Release, generiert aus dem Changelog-Eintrag. create_animation benötigt überhaupt keine Seite, daher reicht der Changelog-Text aus.
• Veraltete Videos aktualisieren. Neu rendern, wenn sich die Seite ändert. Ein Demo-Video, das zum aktuellen Produkt passt, ist mehr wert als ein besser produziertes, das die Benutzeroberfläche des letzten Quartals zeigt.
• Sprachspezifische Varianten. Dieselbe Seite, gefilmt mit Erzählung in jeder Sprache, in der Sie verkaufen.

Priorisieren Sie, bevor Sie generieren. Der Instinkt bei einer API ist, sie auf alles anzuwenden; das Ergebnis ist eine hohe Kreditrechnung und Videos auf Seiten, die niemand besucht. Sortieren Sie nach Traffic, nehmen Sie den oberen Bereich, messen Sie, dann erweitern Sie.

1. 1Standardmäßig KI-Visuals generieren. Eine Pipeline mit aktivierten Clips über einen gesamten Katalog ist der schnellste Weg, ein Guthaben zu leeren – ein hauseigener Clip kostet 311 Credits gegenüber 40 für ein Rendering, und ein benanntes Modell kann weit mehr kosten. Setzen Sie ai_budget bei jedem Aufruf und standardisieren Sie es für Massenarbeiten auf Null.
2. 2Unveränderte Seiten nach Zeitplan neu rendern. Auslösen bei Änderung, nicht über einen Cron-Job. Ein nächtlicher Job über einen statischen Katalog zahlt jede Nacht den vollen Preis für identische Ausgaben.
3. 3Die Warnungen ignorieren. Sie sind das Einzige, was zwischen einer automatisierten Pipeline und der Veröffentlichung eines Films steht, dessen Schlüsselszene stillschweigend auf eine Textkarte zurückgefallen ist.

Renderings werden pro Konto einzeln und nicht gleichzeitig ausgeführt. Das Einreichen von zweihundert Jobs reiht sie also in die Warteschlange ein, anstatt zweihundert Browser zu starten. Bauen Sie für eine Warteschlange: einreichen, ID aufzeichnen, mit Backoff abfragen.

Ein Rendering, das aus einem Systemgrund fehlschlägt, wird automatisch zurückerstattet, sodass ein erneuter Versuch nach einem echten Fehler nicht doppelt bezahlt wird. Ein Rendering, das fehlschlägt, weil die Seite nicht erreicht werden konnte – eine Roboterprüfung, eine Anmeldewand, eine tote URL – wird abgelehnt, bevor etwas berechnet wird, und es wird so lange abgelehnt bleiben, bis sich die Seite ändert. Das Wiederholen in einer Schleife bringt nichts; prüfen Sie den Grund und überspringen Sie es.

Für Seiten hinter einem Login registrieren Sie zuerst eine Erfassungssitzung über die VS Code- oder Browser-Erweiterung. Diese ist auf den jeweiligen Ursprung beschränkt, läuft innerhalb von drei Tagen ab und ist eine Funktion des Scale-Plans.