SuperAPI AI 工具集

footage-cutlist

设计与创作

查看项目

更新于 10-15 21:54

技能介绍

用途:从品牌自有产品素材(屏幕录制、产品影片)中,为每条文案挑选能证明该文案的画面片段,并渲染成产品视频图层。挑选属于判断而非公式,因此工具只做机械部分,把决定权留给智能体与用户。

主要能力:survey.py 以约 1 帧/秒扫描整段素材,输出 survey.json,列出剪辑点(场景变化)、运动(每秒变化量)和静止段(1.5 秒以上无变化,死屏会被读成卡住的视频);可用 --from/--to/--every/--frames 对某段密集重扫并导出单帧。preview.py 依据 cutlist.json 生成 review.png 审阅表。cut.py 渲染已批准的片段,支持 --draft。

使用方式: python survey.py --video footage.mp4 --out work/survey python survey.py --video footage.mp4 --out work/s-12 --from 12 --to 18 --every 0.25 --frames python preview.py --cutlist work/cutlist.json --out work/review.png python cut.py --cutlist work/cutlist.json --out work/layer.mp4 [--draft]

cutlist.json 定义 size、fps、seam、creator_side、bg、sources 与 beats。每个 beat 含 id、start、end、state(creator/split/product)、vo,以及 source、in、fit、why。in 为源内起点,out 默认 in+slot(1.0x),窗口可 0.5x–2x,不循环不冻结。fit 可选 width(默认,整帧加黑边)、cover、crop(源框 [x0,y0,x1,y1] 分数)。bg 可选 auto(取素材角落颜色)、blur 或 #rrggbb。look 支持 screen 模式(细边框、暗房、摩尔纹、颗粒、缓慢手持漂移),含 rot、keystone、fill、fit、drift 与遮罩框。transition 支持 dissolve_frames(如 7 帧交叉溶解)。源也可为静态图(png/jpg/webp),需给 look: "screen" 让漂移保持画面活性。beats 必须从 0 起无缝铺满时间线,否则 cut.py 拒绝。

适用场景:为品牌产品视频按文案逐句匹配画面,需要人工与智能体多轮确认剪辑清单时使用。

限制与注意事项:先看完整段素材再选;不要凭 1fps 一瞥定窗口,需以 --every 0.25 重扫并逐帧查看;文案所述内容必须在说该句时可见;含文字的素材不要裁切,默认 fit: width;避免死屏;屏幕区域应接近目标框形状;注意素材中的第三方 logo 或名称,需裁掉或遮罩;不要重复使用同一素材,cut.py 会在同源两 beat 重叠时警告;配音对齐后需重跑 preview.py 与 cut.py 复查。挑选免费,可多轮迭代,用户批准剪辑清单前不要投入创作者环节。官方未提供收费、价格或平台信息。