# 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

1. Das Videoschema erzeugen oder zusammensetzen
2. Die Schemastruktur und Asset-Referenzen validieren
3. Eine Vorschau erstellen
4. Das Schema prüfen oder verfeinern
5. Die finale Render-Aufgabe starten
6. Den Aufgabenstatus abfragen oder einen Webhook empfangen
7. 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](https://renderingvideo.com/docs/json-spec.md).

## 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](https://renderingvideo.com/docs/api-and-usage.md).

## Verwandte Dokumente

- Schema-Details: [JSON-Struktur und Feldregeln](https://renderingvideo.com/docs/json-spec.md)
- Laufzeitablauf: [API und Verwendung](https://renderingvideo.com/docs/api-and-usage.md)
- Kopierbare Payloads: [Beispiele](https://renderingvideo.com/docs/examples.md)
- Schritt-für-Schritt-Anleitungen von Grund auf: [Tutorials](https://renderingvideo.com/docs/tutorials.md)