에셋 가져오기
이 빌드는 에디터와 미디어 서버를 로컬에서 실행합니다. 호스팅된 가져오기 API, CLI, OAuth는 없습니다. 미디어는 에디터 UI 또는 아래 에이전트 도구를 통해 프로젝트에 들어옵니다. 바이트가 있는 위치에 따라 경로를 선택하세요.
경로 1 — 사용자 로컬 파일 (기본)
사용자에게 파일을 에디터(미리보기 캔버스 또는 내 자료 패널)로 드래그하거나 업로드 버튼을 사용하도록 요청하세요. 그러면 로컬 파이프라인이 자동으로 실행됩니다: 스트리밍 쓰기 → /media/uploads/에 저장, 조건부 트랜스코딩(최대 1920px 긴 쪽, 브라우저 호환 코덱, ~8Mbps), 오디오 추출, 자동 전사(ASR은 업로드 시 시작). 사용자에게 직접 변환, 자르기, 트랜스코딩을 요청하지 마세요 — 파이프라인이 처리합니다.
에이전트는 사용자의 파일 시스템을 읽을 수 없습니다. 사용자가 /Users/... 또는 C:\... 경로를 제공하면 해당 파일을 에디터에 드롭하도록 안내하세요. 에이전트는 가져올 수 없습니다.
경로 2 — 공개 URL (에이전트 주도)
단일 URL 또는 배치 배열과 함께 download_media를 사용하세요. 서버가 가져와서 /media/uploads/에 저장하고 풀 에셋을 등록합니다. 사용자가 가리킨 스톡/웹 미디어에 이 방법을 선호하세요. 다운로드 후 에셋은 다른 미디어 풀 에셋과 동일하게 동작합니다.
경로 3 — 외부 호스트 전송
import_media를 {"action":"create_session", "assetType":..., "filename":..., "contentType":..., "size":...}와 함께 호출하세요. 이 호출은 현재 프로젝트, 세션, 에셋 ID, 기본 이름, POST, MIME 타입, 정확한 바이트 수에 바인딩된 단기 업로드 슬롯을 반환합니다. 호스트 측 스크립트는 선언된 헤더와 함께 해당 정확한 URL로 업로드할 수 있습니다. 에이전트 샌드박스는 사용자의 localhost에 도달할 수 없으므로 run_code로 전송을 시도하지 마세요.
성공적인 업로드 응답은 불투명한 영수증, 에코된 assetType, 업로드된 경로를 반환합니다. 정확한 지속 시간, 크기, fps, 오디오 유무가 필요할 때 업로드된 경로를 조사한 후, finalize_uploaded_asset을 영수증, 에코된 assetType, 측정된 미디어 메타데이터 및 오디오/비디오/gif의 경우 durationInSeconds와 함께 호출하세요. 서버는 권위 있는 해시, 경로, 크기, 파일 이름, 에셋 ID를 해결합니다. Finalize는 에셋을 커밋하지만 ASR을 시작하지 않습니다. 오디오/비디오 에셋을 트랙에 배치한 후 전사가 필요한 경우 별도로 transcribe_track을 호출하세요. Finalize가 성공하기 전에는 에셋이 존재하지 않거나 사용할 수 없습니다. 누락된 미디어를 교체하려면 기존 assetId를 import_media에 전달하고, 새 에셋의 경우 생략하세요. 직접 /media/uploads/...를 구성하거나 업로드 응답 전에 바이트가 준비되었다고 주장하지 마세요.
편집 규율
다중 소스 편집의 경우 OpenChatCut 타임라인에서 원본 소스 에셋으로 검토 가능한 작업을 구축하세요. 가져오기 전에 로컬에서 연결, 사전 트림, 사전 구성, 캡션 굽기 또는 미디어 평탄화를 하지 마세요 — 원본을 가져와 모든 구성을 타임라인에서 수행하여 모든 단계가 검토 가능하고 취소 가능하도록 유지하세요.
Motion Graphics와 같은 코드 에셋의 경우 create-motion-graphics 스킬(create_motion_graphic_from_code 신규 에셋, 편집을 위한 에셋 코드 업데이트)을 사용하세요 — MG 코드는 가져온 파일이 아닙니다.
저장소 참고 사항
- 바이트는 로컬 디스크(
/media/uploads/)에 저장되며 Range 지원과 함께 직접 제공됩니다. Cloudflare R2가 구성된 경우 업로드는 R2로 미러링되고 다른 기기에서 가져올 수 있습니다. R2 없이 프로젝트는 로컬 전용입니다. - 로컬 전용은 유효한 최종 상태입니다: 미리보기, 편집, 내보내기 모두 디스크에서 읽습니다. 클라우드 미러링은 기기 간 접근에만 필요합니다.