Export
Verwenden Sie die Export-Werkzeuge von OpenChatCut für die Auslieferung. Eine Exportanfrage sollte submit_export (oder submit_render_job für asynchrone Verarbeitung) aufrufen, dann track_export für den Status und die endgültige Auslieferung verwenden, wenn das Ergebnis nicht sofort zurückgegeben wird.
Standardrichtlinie:
- Bevorzugen Sie
submit_export, wenn der Benutzer die OpenChatCut-Timeline exportieren/freigeben/finalisieren möchte. - Behalten Sie Originale während der Bearbeitung standardmäßig lokal. Laden Sie Originale nur hoch, wenn ein Cloud-Export/Nachweis Remote-Assets benötigt und der Benutzer den Upload nicht verboten hat.
- Wickeln Sie Sandbox-
ffmpeg-Arbeiten nicht als OpenChatCut-Tool ein. Verwenden Sie Sandbox-ffmpegfür die vollständige Videoverarbeitung nur, wenn der Benutzer ausdrücklich einen eigenständigen lokalen Dateivorgang außerhalb eines OpenChatCut-Bearbeitungs-Workflows anfordert. Für OpenChatCut-Bearbeitungsaufgaben erstellen Sie keine vorbearbeitete oder flache lokale Render-Ausgabe als primäre Überprüfung/endgültige Auslieferung; verwenden Sie den OpenChatCut-Export.
Dauerhafter Export
Verwenden Sie submit_export für den Ausführungspfad:
{
"format": "video",
"codec": "h264",
"resolution": "1080p",
"fps": 30,
"name": "final-cut"
}
Video-Codec-Optionen sind h264 (MP4, Standard) und vp8 (WebM). Video-Bildratenoptionen entsprechen der Editor-Oberfläche: 24, 25, 30, 50 oder 60; lassen Sie fps weg, um die Timeline zu übernehmen. Audio-Export ist MP3: Übergeben Sie "format":"audio" und lassen Sie codec / fps weg, es sei denn, Sie übergeben explizit "codec":"mp3".
submit_export gibt eine dauerhafte renderId zurück. Einige Exporttypen, wie Untertiteldateien, können sofort abgeschlossen werden und geben downloadUrl zurück; Video/Audio erfordern normalerweise track_export, um auf den Abschluss zu warten.
Nachdem Sie jede downloadUrl erhalten haben:
- Ermitteln Sie den Downloads-Ordner des Benutzers:
~/Downloadsunter macOS/Linux oder%USERPROFILE%\Downloadsunter Windows. - Bevor Sie einen Agent-/Browser-Download auslösen, überprüfen Sie den Downloads-Ordner auf frische Chrome-Download-Artefakte aus den letzten Minuten, die mit dem erwarteten Exportnamen, der Erweiterung oder dem Basisnamen der Render-/Download-URL übereinstimmen. Berücksichtigen Sie sowohl abgeschlossene Dateien als auch laufende
.crdownload-Dateien. - Wenn eine passende frische
.crdownload-Datei existiert, lösen Sie keinen weiteren Download aus. Warten Sie, bis Chrome das.crdownload-Suffix entfernt hat und die endgültige Dateigröße sich nicht mehr ändert, und verwenden Sie dann diese abgeschlossene Datei. - Wenn bereits eine passende frische, abgeschlossene Datei existiert, verwenden Sie diese direkt, anstatt erneut herunterzuladen.
- Wenn nur ältere Dateien vorhanden sind, behandeln Sie diese als Kollisionen, nicht als den aktuellen Export.
- Überschreiben Sie keine vorhandene Datei; wählen Sie bei Bedarf einen sicheren, nummerierten Dateinamen wie
name (1).mp4. - Laden Sie die fertige Exportdatei immer in den Downloads-Ordner herunter, nicht in ein temporäres/Arbeitsverzeichnis.
- Zeigen Sie das heruntergeladene Video immer inline im Chat an. Wenn mehrere Videos exportiert wurden, laden Sie alle herunter und zeigen Sie jede Vorschau an, nicht nur die erste.
Wenn das Projekt lokal gespeicherte Assets enthält, laden Sie cloud-lesbare Ersatzdaten vor dem Rendern hoch/registrieren Sie sie, oder verwenden Sie den lokalen CLI-Exportpfad, wenn der Benutzer lokal bleiben möchte.
Melden Sie die zurückgegebene renderId, wenn vorhanden. Der Auftrag ist auch in der Export-Warteschlange oben rechts im Editor sichtbar, einschließlich Fortschritt und Abbruchmöglichkeit. Verwenden Sie saveToMediaPool:true, wenn der Benutzer darum bittet, das Ergebnis in „Meine Medien“ zu behalten, oder wenn der aktive Workflow explizit eine automatische Materialisierung vorsieht, wie z. B. livestream-to-clips; andernfalls bleibt die Standardeinstellung ein normaler, herunterladbarer Export. Rufen Sie bei langen Videos einmal track_export mit action:"wait" und timeoutSeconds:20 auf. Wenn es waitExpired:true zurückgibt, melden Sie, dass der Render-Vorgang im Hintergrund fortgesetzt wird, und beenden Sie den Turn. Überprüfen Sie es später mit action:"status"; wiederholte Wartezeiten halten nur den Agent-Turn offen. Starten Sie keinen weiteren Export für dieselbe Timeline, während dieser Render aktiv ist.
Verwenden Sie track_export, wenn der Benutzer nach dem Export-/Render-Status fragt oder wenn der aktuelle Turn wirklich auf einen eingereichten Video-/Audio-Render warten muss. Abgeschlossene Connector-Exports geben downloadUrl zurück; Laden Sie für jeden abgeschlossenen Eintrag die Datei mit den oben genannten, kollisionssicheren Regeln in den Downloads-Ordner herunter und zeigen Sie sie inline im Chat an:
{
"action": "status",
"renderIds": "abc123"
}
Für den letzten Projektexport lassen Sie renderIds weg und übergeben Sie "latest": true. track_progress ist für Generierungs-/Transkriptions-/Upload-Aufträge, nicht für Render-Aufträge.
Für NLE-XML verwenden Sie submit_export mit format:"xml":
{
"format": "xml",
"nleFormat": "fcp_xml_resolve",
"timelineId": "abc123"
}
nleFormat-Werte sind fcp_xml für Premiere-XML (Standard) und fcp_xml_resolve für DaVinci-Resolve-XML. Lassen Sie timelineId für die aktive Timeline weg oder übergeben Sie eine Timeline-ID/ein Präfix für eine nicht aktive Timeline. Lesen und melden Sie Warnungen: Untertitel, Volltonfarben, SVG, nicht unterstützte Clip-Attribute und ungerenderte Bewegungsgrafiken können vom XML-Format entfernt werden. Bewegungsgrafiken werden in XML nur dargestellt, wenn ein transparenter ProRes-MG-Export-Workflow motionGraphicRenderKeys bereitstellt; andernfalls meldet der Exporteur sie als entfernt.
Verwenden Sie für den Medienpool-Quelldownload request_asset_download für ein dateibasiertes Quell-Asset. Es gibt eine geschützte Backend-Download-URL/einen geschützten Pfad für das ursprüngliche Quellmedium zurück. Verwenden Sie pull_asset nicht für Benutzer-Downloads; pull_asset ist nur für die Sandbox.
Für Untertiteldateien verwenden Sie submit_export mit format:"subtitles":
{
"format": "subtitles",
"subtitleFormat": "srt"
}
Formate sind srt und txt. Der Export verwendet das tatsächliche Timeline-Wort-Timing des Untertitel-Elements, den Quellenbereich, Übersetzungsvarianten, Text-Override-Anzeigen und Tempofelder wie wordsPerPage / maxCharactersPerLine und erstellt einen dauerhaften, herunterladbaren Exportauftrag. Es ist für herunterladbare Untertiteldateien geeignet. Es verwendet noch nicht den Browser-Remotion-Untertitel-Seitenplaner, daher sind visuelle Zeilenumbrüche/Seitenumbrüche timing-korrekt, aber angenähert und nicht byte-identisch mit der Paginierung von eingebrannten Untertiteln. Übergeben Sie für nicht aktive Timelines timelineId von manage_timelines oder read_project.
Verwenden Sie für eine einzelne Bewegungsgrafik als transparentes ProRes 4444 export_motion_graphic_prores:
{
"itemId": "abc123",
"filenameMode": "asset"
}
Bevorzugen Sie itemId beim Exportieren einer bestimmten Timeline-Instanz, da das Element live propertyOverrides wie bearbeiteten Text enthält. Verwenden Sie assetId für eine Medienpool-Bewegungsgrafik; das Backend verwendet die erste Timeline-Instanz für dieses Asset, sofern vorhanden, entsprechend dem Verhalten des Editors beim Medienpool-Export. Übergeben Sie für mehrere Bewegungsgrafiken itemIds oder assetIds in einem Aufruf. Jede Bewegungsgrafik wird dennoch zu einem separaten dauerhaften Render; verwenden Sie track_export mit den zurückgegebenen renderIds, um zu warten, und laden Sie dann über jeden zurückgegebenen Render-Download-Pfad herunter.
Wenn Sie XML vorbereiten, das auf gerenderte Bewegungsgrafiken verweisen soll, übergeben Sie "filenameMode":"xml" und dieselbe timelineId an export_motion_graphic_prores, und behalten Sie den zurückgegebenen motionGraphicRenderKey / die zurückgegebenen motionGraphicRenderKeys; nach Abschluss des Renderns übergeben Sie diese Schlüssel und dieselbe timelineId in submit_export.motionGraphicRenderKeys mit format:"xml".
Lokaler Render (dieser Build)
Das gesamte Rendering erfolgt lokal: submit_export / submit_render_job steuern den lokalen Render-Dienst (Headless Chrome über denselben Timeline-Status, den der Editor anzeigt) und lesen Medien direkt von /media/uploads/ auf der Festplatte. Es gibt keine S3-Anforderung, kein CLI und keinen Cloud-Job, auf den für plattenbasierte Assets gewartet werden muss.
submit_export: Untertitel/XML werden synchron zurückgegeben; Video/Audio werden in diesem Build ebenfalls im Aufruf gerendert (lange Timelines können eine Weile dauern – warnen Sie den Benutzer anstatt zu pollieren).submit_render_job+track_export: der asynchrone Weg – gibt sofort einerenderIdzurück, pollieren Sie mittrack_export(renderIds/latest/onlyActive), und übergeben Sie dem Benutzer dann den zurückgegebenen Download-Pfad.- Assets, die sich noch auf
blob:-Platzhaltern befinden (Upload ist im Gange), sind noch nicht renderbar – warten Sie auftrack_progresstarget=upload, das die Bereitschaft meldet, bevor Sie einreichen.
Fallbacks
Wenn ein Render fehlschlägt, weil die Bytes eines Assets fehlen (Platzhalter nie neu verknüpft, Datei von der Festplatte gelöscht):
- Bitten Sie den Benutzer, das Asset unter „我的素材 (离线素材横幅)“ neu zu verknüpfen oder die Datei erneut zu importieren.
- Führen Sie für URL-quellierte Medien
download_mediaerneut aus, um Bytes wiederherzustellen, und reichen Sie es dann erneut ein.
Teilen Sie dem Benutzer nicht mit, dass er HTML-in-Canvas, Remotion oder Speicherinterna verstehen muss, es sei denn, es wird debuggt. Erklären Sie es auf Produktebene:
- "本地快速导出"
- "素材还在上传,稍等再导"
- "需要先重新链接本地素材"
Ergebnisverfolgung
Notieren Sie für submit_export:
renderId- Timeline/Bereich/Auflösung/Codec/fps
- dass der Benutzer aus dem Render-Auftrags-Panel des Editors herunterladen kann
Notieren Sie hochgeladene Asset-IDs und alle Fallbacks, die versucht wurden, als der Cloud-Export durch lokale Assets blockiert wurde.