Video-Concatenation-API für Entwickler: MP4, MOV und AVI per REST verbinden

Video-Concatenation-API für Entwickler: MP4, MOV und AVI per REST verbinden

Videopipelines erhalten ihre Assets häufig aus mehreren Quellen. Eine mobile Anwendung lädt MP4 hoch, eine Kamera-Integration liefert MOV und ein Archiv enthält noch AVI oder MPEG. Wenn das nachgelagerte System eine einheitliche Mediendatei erwartet, muss jedes Integrationsteam Eingaben prüfen, normalisieren, zusammenfügen und ein abrufbares Ergebnis bereitstellen. VideoConcat bietet diese Funktion als asynchrone REST-API zur Videokonkatierung.

Endpunkt und Request-Modell

Authentifizierte Clients senden eine Multipart-Anfrage an POST /api/files/start-process. Setzen Sie actionName=VideoConcat, übertragen Sie 2 bis 15 Videodateien als file0 bis file14 und senden Sie wie in den öffentlichen Beispielen parameters=[] sowie async=true. Öffentliche URLs können in fileUrl mit dem Trennzeichen | übergeben werden; Uploads und URLs dürfen kombiniert werden. Die vollständigen Beispiele stehen in der VideoConcat-API-Dokumentation.

Die erste Antwort enthält einen Prozessdatensatz, nicht schon das fertige Medium. Speichern Sie id und trackingUrl und fragen Sie /api/actions/get-action-infos/{id} mit demselben Bearer-JWT ab, bis der Prozess beendet ist. So muss die HTTP-Anfrage während Normalisierung und Kodierung nicht offen bleiben.

Warum die Asynchronität wichtig ist

Die Laufzeit hängt von Anzahl, Größe, Dauer und Auflösung der Clips ab. Ein kleiner Satz kompatibler Videos ist schnell verarbeitet, während große oder lange Quellen mehr Rechenzeit benötigen. Eine asynchrone Merge-Videos-API kann die Anfrage bestätigen, die Prozess-ID speichern und den eigenen Jobstatus über den Status-Endpunkt aktualisieren. Ein Worker beendet den Vorgang unabhängig von der Webanfrage.

Behandeln Sie die Prozess-ID als Statusreferenz, nicht als Autorisierung. Verwenden Sie bei Status- und Download-Anfragen weiterhin den authentifizierten Kontext und die vom Server bereitgestellten Ergebnislinks. Die Kenntnis einer Integer-ID darf allein keinen Zugriff auf ein Ergebnis geben.

Vorhersehbare Ausgabe

VideoConcat normalisiert jede Quelle vor dem Zusammenfügen. Akzeptiert werden 3GP, AVI, FLV, M4V, MKV, MOV, MP4, MPEG, MPG, OGV, TS, WebM und WMV; unterschiedliche Endungen dürfen in einer Anfrage vorkommen. Die Ausgabe zielt auf eine gemeinsame Auflösung bis zu 1920×1080, 30 Bilder pro Sekunde, H.264 und AAC. Letterboxing erhält den Bildausschnitt bei abweichenden Seitenverhältnissen, und bei fehlendem Ton wird eine stille Audiospur ergänzt.

Bei Erfolg wird eine herunterladbare MP4 bereitgestellt. Das erleichtert die Übergabe an eine Transcoding-Queue, einen Asset-Manager, einen Publishing-Workflow oder ein Kundenportal. Die fachliche Prüfung der Clips und eine redaktionelle Freigabe bleiben Aufgabe Ihrer Anwendung.

Validierung und Eigentumsgrenzen

Die Servervalidierung prüft Anzahl, echten Medieninhalt, MIME-Informationen, Eigentum und Grenzen. Jede Datei ist auf 100 MB und 10 Minuten begrenzt; die gesamte Anfrage auf 1 GB und 30 Minuten. Sie muss 2 bis 15 Videos enthalten. Diese Regeln hängen weder von Dateiendung, JavaScript noch vom behaupteten Browser-MIME ab.

clip.mp4 beweist nicht, dass die Bytes ein gültiges MP4 enthalten, und ein Dateiauswahldialog ist keine Autorisierungsgrenze. Senden Sie nur Dateien des authentifizierten Kontos, schützen Sie das JWT und behandeln Sie stabile Validierungsfehler als Eingabefehler statt sie endlos zu wiederholen. Öffentliche URLs sollten Quellen entsprechen, deren Verarbeitung Ihre Anwendung erlaubt.

Preis und Retries

Eine erfolgreiche Verarbeitung kostet 15 Tokens. Eine Validierungsablehnung wird nicht berechnet, sodass Kardinalitäts- oder Größenfehler korrigiert werden können, ohne eine erfolgreiche Verarbeitung zu bezahlen. Unterscheiden Sie in Ihrem Job-System abgelehnte, laufende, fehlgeschlagene und erfolgreiche Prozesse. Starten Sie nicht wegen eines abgelaufenen Polling-Aufrufs sofort einen zweiten Prozess, sondern lesen Sie zuerst den bestehenden Status.

Speichern Sie die Prozess-ID und verwenden Sie ein begrenztes Polling mit passendem Backoff. Nach Erfolg speichern Sie die Ergebnisreferenz und laden über den authentifizierten Ergebnisfluss. Auch ein eigener Webhook- oder Queue-Konsument sollte doppelte Benachrichtigungen idempotent behandeln.

Typische Integrationen

Die API eignet sich zum Zusammenstellen kundenseitig hochgeladener Clips, für eine Review-Kopie aus mehreren Kameras, für eine Übergabedatei an ein CMS oder zum Archivieren öffentlicher Trainingssegmente. Ihre Anwendung kann MP4 und MOV aus verschiedenen Upload-Pfaden akzeptieren, ohne Anwendern FFmpeg oder einen Desktop-Editor erklären zu müssen.

Die vollständigen Multipart-Beispiele, Statusantworten und Download-Details finden Sie in der REST-Dokumentation von VideoConcat. Für MP4, MOV, AVI und weitere unterstützte Quellen liefert die API einen kleinen, nachvollziehbaren Vertrag für asynchrone Verarbeitung.