用途:帮助理解并操作 AIcut 视频剪辑系统,覆盖项目管理、时间轴编辑、添加媒体、创建字幕和导出视频等任务。
主要能力:项目生命周期管理(新建、查看、切换、删除、归档);时间轴元素操作,包括媒体元素(视频/图像/音频)与文本/字幕元素;通过 API 或 Python SDK 添加字幕、批量添加字幕、清除字幕、更新快照;媒体工具支持本地文件转浏览器可访问 URL 及从视频生成 JPG 缩略图。
使用方式:优先使用 Python SDK(scripts/aicut_sdk.py)而非原始 HTTP 请求。常用脚本包括 aicut_tool.py(集中式 CLI,如 python scripts/aicut_tool.py media import "path/to/video.mp4")、aicut_sdk.py(核心库,from aicut_sdk import AIcutClient)、fix_subtitle_pos.py(字幕底部居中)、project_manager.py(项目生命周期,如 python scripts/project_manager.py list)。前端状态同步 API 为 POST /api/ai-edit,支持 addSubtitle、addMultipleSubtitles、clearSubtitles、switchProject、archiveProject、deleteProject、updateSnapshot 等动作。
关键约定:项目快照位于 ai_workspace/project-snapshot.json;项目文件夹为 projects/<display-name>/,通过 projects/projectIdMap.json 映射内部 ID;素材在 assets/,导出在 exports/。文本元素以 content 为唯一文本字段,样式需平铺在顶层,且必须包含 trimStart、trimEnd、rotation、opacity 默认值。坐标系原点在左上角,画布 1920x1080,中心为 (960, 540)。
限制与注意:避免在 Windows 使用 curl,改用临时 Python 脚本或 SDK;不要使用 /materials/ 相对路径,应使用绝对路径并包裹在 /api/media/serve?path= 中;更新采用原子方式,先读完整快照再写回;数值字段须为 number 类型;文本轨道应置于顶层。资料未提供收费、价格、平台支持范围及具体效果等信息。