用途:该技能解决横屏素材转竖屏 Reel 时裁切偏移的问题。横屏画面居中裁成竖屏时通常只保留约三分之一宽度,若直接按中心裁切,主体常被裁到画面边缘甚至消失。因此该技能改为先测量主体位置,再由脚本按测量结果裁切片段。
主要能力:
- 按源和目标画幅进行一次画面重构。调用 picsart_media_reframe_video,传入源素材在 Picsart 托管的 URL 与成片的 aspect_ratio,返回任务回执;该过程需数分钟,应尽早发起,且不依赖剪辑结果。完成结果需原样保存为 reframe-<source id>.json。同一源素材与画幅在整个会话中只重构一次,覆盖源素材全长,后续所有剪辑、重剪和新顺序都从中取窗。
- 无需重构的情况:源素材画幅已与成片一致,或画面中无可跟随主体(标题卡、满屏图形、无主体宽镜头)时,片段直接 full 呈现。
- 生成片段:用 scripts/reel_cut.py 读取 reel.json,指定成片 width/height、源素材列表(含 url、reframe 文件引用或尺寸与时长)和片段列表(source、in、out、frame、dim 等)。片段按列表顺序播放,时间以各自源素材的秒为单位。已重构源默认 crop(跟随主体),其余默认 full(整帧叠在模糊副本上,dim 控制变暗程度,或 background 设为 black)。照片无自身时长,片段需给出 duration;full 显示全图,crop 从中心填充。
- camera 摇摆检测:重构跟随每帧中的主体,未必是说话者,双人镜头可能在两人间摇摆。脚本会在 notes 中标注镜头跨越幅度过大的片段并给出建议的 hold 中心值;可给片段加 hold(0 为左边缘,1 为右边缘)固定单一窗口,或选择仅说话者在画面中的片段。
- 验证:场景送审前先用 picsart_scene_validate 校验,再用 picsart_scene_contact_sheet 在每个接缝和片段中点出图,检查每帧裁切中是否有完整人脸,且没有以墙面或手部开场的片段,问题在新一轮运行中修正。
使用方式:确认源素材与成片画幅,发起重构并保存结果;将 reel_cut.py 输入写入文件后运行 python3 scripts/reel_cut.py reel.json;脚本输出一行 JSON(scene、duration、clips、notes),scene 可直接交给场景编辑器使用。重剪即修改片段列表后重新运行脚本,重构结果保持不变。若重构失败可重试一次,仍失败则说明当前不可用。严禁根据视频描述估计主体位置,也不得用整帧人物替代裁切。
适用场景:横屏访谈、口播视频转为竖屏短视频、Reel 等;包含人物或可跟随主体的素材;混合使用视频与照片的成片;需要重剪而不重复测量的场景。
限制:重构耗时数分钟,服务不稳定可能失败;是否消耗 credits 以接口描述为准,若收费需在同一次中统一报价;不适用于无主体或画幅一致的素材。过渡默认硬切,仅在用户要求时添加。