Leitfaden: JSON zu Video

Wann man ihn verwenden sollte

Verwende einen Workflow JSON zu Video, wenn:

die Videoausgabe aus strukturierten Daten abgeleitet wird
du mehrere Varianten aus derselben Template-Logik benötigst
ein Produkt, Agent oder Automatisierungssystem die Videoerstellung auslösen muss
du Vorschauen vor der finalen Ausgabe möchtest
du asynchrone Render-Aufgaben und Zustell-Callbacks benötigst

Wenn der Workflow hauptsächlich daraus besteht, dass eine Person jeweils ein einzelnes Video bearbeitet, ist ein manueller Editor möglicherweise einfacher. Wenn der Workflow Wiederholbarkeit und Software-Integration braucht, ist JSON in der Regel die bessere Steuerungsoberfläche.

Empfohlener Workflow

Das Videoschema erzeugen oder zusammensetzen
Die Schemastruktur und Asset-Referenzen validieren
Eine Vorschau erstellen
Das Schema prüfen oder verfeinern
Die finale Render-Aufgabe starten
Den Aufgabenstatus abfragen oder einen Webhook empfangen
Das finale Asset speichern oder ausliefern

Checkliste für die Implementierung

Definiere die Form des Videoschemas, das dein Produkt erzeugen wird
Entscheide, wie Assets hochgeladen oder referenziert werden
Validiere erforderliche Felder vor dem Rendern
Erzeuge Vorschauen zur Prüfung durch Benutzer oder Systeme
Speichere Aufgaben-IDs und Statusübergänge
Behandle fehlgeschlagene Render-Vorgänge und Wiederholungen
Liefere finale Assets über Polling oder Webhooks aus
Halte wiederverwendbare Templates getrennt von Laufzeitdaten

Minimale Schema-Oberfläche

Ein Produktionsschema benötigt in der Regel:

meta für Canvas-Einstellungen und Video-Metadaten
assets für Bilder, Videos, Audio und Schriftarten
tracks für die Timeline-Struktur
clips für Text, Medien, Formen, Untertitel und Layouts
Regeln für Timing und Animation
Informationen zur Ausgabe und zum Aufgaben-Lebenszyklus

Die genauen feldbezogenen Regeln findest du in der Referenz JSON-Struktur und Feldregeln.

Vorschau, Rendern und Auslieferung

Vorschau: einen schnellen Entwurf erzeugen, um Layout und Texte zu prüfen
Rendern: das finale Ausgabe-Asset erzeugen
Auslieferung: das Ergebnis über Polling, eine Aufgabenabfrage oder einen Webhook bereitstellen

Für API-spezifische Details siehe weiter bei API und Verwendung.