Video-Rendering-API: Vom Schema bis zur ausgelieferten MP4

Rendering ist asynchron und sollte nicht als einzelner langer HTTP-Aufruf modelliert werden. RenderingVideo trennt das Anlegen einer Aufgabe vom Start des Renderings. Dadurch können Teams zuerst validieren und erst nach Freigabe Credits verbrauchen.

Wichtige Prinzipien

• Capabilities vor neuen Schema-Funktionen abfragen.
• API-Keys ausschließlich im vertrauenswürdigen Backend speichern.
• Remote Task-ID, Status, Eingaberevision und Ergebnis-URL persistieren.
• Polling und Webhooks gemeinsam einsetzen.

Empfohlener Ablauf

1. Schema und öffentlich erreichbare Assets validieren.
2. Mit POST /api/v1/video eine Aufgabe anlegen.
3. Über POST /api/v1/video/:taskId/render das Rendering starten.
4. Abschluss verarbeiten und die Ausgabe nach eigener Retention-Strategie speichern.

Produktionstipp

Idempotenz verhindert doppelte Aufgaben und unnötigen Credit-Verbrauch. Ein lokaler Job sollte genau einer RenderingVideo-Aufgabe entsprechen.

Weiterlesen