Importation d'actifs
Cette build exécute l'éditeur et son serveur multimédia localement. Il n'y a pas d'API d'importation hébergée, pas de CLI ni d'OAuth : les médias entrent dans le projet via l'interface utilisateur de l'éditeur ou via les outils agent ci-dessous. Choisissez le chemin en fonction de l'emplacement des octets.
Chemin 1 — fichiers locaux de l'utilisateur (principal)
Demandez à l'utilisateur de faire glisser les fichiers dans l'éditeur (zone de prévisualisation ou panneau 我的素材) ou d'utiliser le bouton de téléchargement. Le pipeline local s'exécute ensuite automatiquement : écriture en streaming vers /media/uploads/, transcodage conditionnel (≤1920 bord long, codec compatible navigateur, ~8Mbps), extraction audio et transcription automatique (la RAP démarre au téléchargement). Ne demandez pas à l'utilisateur de pré-convertir, pré-recadrer ou transcoder quoi que ce soit lui-même — le pipeline s'en charge.
L'agent ne peut pas lire le système de fichiers de l'utilisateur. Si l'utilisateur vous donne un chemin /Users/... ou C:\..., dites-lui de déposer ce fichier dans l'éditeur à la place ; vous ne pouvez pas le récupérer.
Chemin 2 — URL publiques (piloté par l'agent)
Utilisez download_media avec une seule URL ou un tableau de lots. Le serveur récupère, stocke sous /media/uploads/ et enregistre les actifs du pool. Préférez cette méthode pour les médias stock/web pointés par l'utilisateur. Après le téléchargement, l'actif se comporte comme n'importe quel autre actif du pool multimédia.
Chemin 3 — transfert depuis un hôte externe
Appelez import_media avec {"action":"create_session", "assetType":..., "filename":..., "contentType":..., "size":...}. Cela renvoie un emplacement de téléchargement à courte durée de vie lié au projet actuel, à la session, à l'identité de l'actif, au nom de base, POST, au type MIME et au nombre exact d'octets. Un script côté hôte peut télécharger vers cette URL exacte avec les en-têtes déclarés. Le bac à sable de l'agent ne peut pas atteindre le localhost de l'utilisateur, donc n'essayez pas le transfert depuis run_code.
La réponse de téléchargement réussie renvoie un reçu opaque, un assetType renvoyé et un chemin téléchargé. Sondez le chemin téléchargé lorsque la durée exacte, les dimensions, les fps ou la présence audio sont nécessaires, puis appelez finalize_uploaded_asset avec le reçu, le assetType renvoyé, les métadonnées mesurées du média et durationInSeconds pour audio/vidéo/gif. Le serveur résout le hachage, le chemin, la taille, le nom de fichier et l'ID de l'actif faisant autorité. Finalize valide l'actif mais ne démarre jamais la RAP ; après avoir placé un actif audio/vidéo sur une piste, invoquez transcribe_track séparément si une transcription est souhaitée. L'actif n'est pas présent ni utilisable avant la réussite de finalize. Pour le remplacement d'un média manquant, transmettez l'assetId existant à import_media ; omettez-le pour un nouvel actif. Ne construisez jamais vous-même /media/uploads/... et ne prétendez jamais que les octets sont prêts avant la réponse de téléchargement.
Discipline de montage
Pour les montages multi-sources, construisez un travail révisable à partir des actifs sources originaux dans le timeline d'OpenChatCut. Ne concaténez pas localement, ne pré-recadrez pas, ne pré-composez pas, ne brûlez pas de sous-titres et n'aplatissez pas les médias avant l'importation — importez les originaux et effectuez toute la composition sur le timeline afin que chaque étape reste révisable et annulable.
Pour les actifs de code tels que les graphiques animés créés à la main, utilisez la compétence create-motion-graphics (create_motion_graphic_from_code pour les nouveaux actifs, mises à jour du code des actifs pour les modifications) — le code MG n'est pas un fichier importé.
Notes de stockage
- Les octets résident sur le disque local (
/media/uploads/), servis directement avec prise en charge de Range. Si Cloudflare R2 est configuré, les téléchargements sont mis en miroir vers R2 et d'autres appareils peuvent y puiser ; sans R2, le projet est uniquement local. - Local uniquement est un état final valide : la prévisualisation, le montage et l'exportation lisent tous à partir du disque. La mise en miroir dans le cloud n'est nécessaire que pour l'accès multi-appareils.