Asset-Import
Dieser Build führt den Editor und seinen Medienserver lokal aus. Es gibt keine gehostete Import-API, kein CLI und kein OAuth: Medien gelangen über die Editor-Oberfläche oder die unten aufgeführten Agent-Tools in das Projekt. Wählen Sie den Pfad basierend darauf, wo die Bytes leben.
Pfad 1 — Lokale Dateien des Benutzers (primär)
Bitten Sie den Benutzer, die Dateien per Drag & Drop in den Editor (Vorschau-Canvas oder „Meine Medien“-Panel) zu ziehen oder die Upload-Schaltfläche zu verwenden. Die lokale Pipeline läuft dann automatisch: Streaming-Schreiben nach /media/uploads/, bedingte Transkodierung (≤1920 lange Kante, browserfreundlicher Codec, ~8 Mbit/s), Audio-Extraktion und automatische Transkription (ASR startet beim Upload). Bitten Sie den Benutzer nicht, selbst eine Vorkonvertierung, Vorbearbeitung oder Transkodierung durchzuführen – die Pipeline erledigt das.
Der Agent kann nicht auf das Dateisystem des Benutzers zugreifen. Wenn Ihnen der Benutzer einen Pfad wie /Users/... oder C:\... gibt, sagen Sie ihm, dass er die Datei stattdessen in den Editor ziehen soll; Sie können sie nicht abrufen.
Pfad 2 — Öffentliche URLs (Agent-gesteuert)
Verwenden Sie download_media mit einer einzelnen URL oder einem Batch-Array. Der Server ruft die Medien ab, speichert sie unter /media/uploads/ und registriert Pool-Assets. Bevorzugen Sie diesen Pfad für Stock-/Webmedien, auf die der Benutzer verweist. Nach dem Download verhält sich das Asset wie jedes andere Medienpool-Asset.
Pfad 3 — Externer Host-Transfer
Rufen Sie import_media mit {"action":"create_session", "assetType":..., "filename":..., "contentType":..., "size":...} auf. Es gibt einen kurzlebigen Upload-Slot zurück, der an das aktuelle Projekt, die Sitzung, die Asset-Identität, den Basisnamen, POST, den MIME-Typ und die genaue Byte-Anzahl gebunden ist. Ein Skript auf dem Host kann in diese genaue URL mit den deklarierten Headern hochladen. Die Agent-Sandbox kann nicht auf den Localhost des Benutzers zugreifen. Führen Sie daher keinen Transfer von run_code aus durch.
Die erfolgreiche Upload-Antwort gibt eine undurchsichtige Quittung, den wiedergegebenen assetType und den hochgeladenen Pfad zurück. Überprüfen Sie den hochgeladenen Pfad, wenn genaue Dauer, Abmessungen, fps oder Audio-Präsenz benötigt werden, und rufen Sie dann finalize_uploaded_asset mit der Quittung, dem wiedergegebenen assetType, den gemessenen Medienmetadaten und durationInSeconds für Audio/Video/GIF auf. Der Server löst den autoritativen Hash, Pfad, die Größe, den Dateinamen und die Asset-ID auf. Der Finalisierungsvorgang übergibt das Asset, startet aber niemals ASR; platzieren Sie ein Audio/Video-Asset auf einer Spur und rufen Sie dann separat transcribe_track auf, wenn eine Transkription gewünscht wird. Das Asset ist vor erfolgreichem Finalisieren weder vorhanden noch nutzbar. Für den Austausch fehlender Medien übergeben Sie die vorhandene assetId an import_media; lassen Sie sie für ein neues Asset weg. Konstruieren Sie niemals selbst /media/uploads/... und behaupten Sie niemals, dass Bytes bereit sind, bevor die Upload-Antwort eintrifft.
Bearbeitungsdisziplin
Erstellen Sie für Quellen aus mehreren Quellen überprüfbare Arbeit aus den ursprünglichen Quell-Assets in der OpenChatCut-Zeitleiste. Verketten, vorbearbeiten, vorbereiten, Untertitel einbrennen oder Medien vor dem Import nicht lokal verflachen – importieren Sie Originale und führen Sie die gesamte Komposition auf der Zeitleiste durch, damit jeder Schritt überprüfbar und rückgängig machbar bleibt.
Verwenden Sie für Code-Assets wie handgeschriebene Motion Graphics den Skill create-motion-graphics (create_motion_graphic_from_code für neue Assets, Asset-Code-Updates für Bearbeitungen) – MG-Code ist keine importierte Datei.
Speicherhinweise
- Bytes befinden sich auf der lokalen Festplatte (
/media/uploads/) und werden direkt mit Range-Unterstützung bereitgestellt. Wenn Cloudflare R2 konfiguriert ist, werden Uploads auf R2 gespiegelt und andere Geräte können von dort aus hydrieren; ohne R2 ist das Projekt nur lokal. - Nur-lokal ist ein gültiger Endzustand: Vorschau, Bearbeitung und Export lesen alle von der Festplatte. Cloud-Spiegelung ist nur für geräteübergreifenden Zugriff erforderlich.