SuperAPI AI 工具集

add-zoom-cuts

设计与创作

查看项目

更新于 10-15 21:54

技能介绍

用途:为视频片段或静态图片添加三种缩放运动之一,用于镜头强调与创作者风格动效。

主要能力:zoom-punch 在指定时间点瞬间切换到更紧的裁切;push-in 在整个片段内从起始比例逐渐放大到结束比例;ken-burns 通过 ffmpeg zoompan 实现缓慢平移加缩放,可用于静态图片或视频。

使用方式:通过脚本调用,必需参数为 --source、--type、--output;可选参数包括 --from-scale(默认 1.0)、--to-scale(默认 1.12)、--at(zoom-punch 时间点,默认 0)、--focal(归一化焦点坐标,默认 0.5,0.5)、--fps(默认 30)、--crf(默认 18)、--duration(图片源必需)。示例:python3 skills/atoms/editing/add-zoom-cuts/scripts/zoom_cuts.py --source /path/to/clip.mp4 --type push-in --to-scale 1.15 --output /path/to/clip-zoom.mp4。

输出:重新编码的 mp4 文件,以及同目录下的 manifest.json,记录缩放参数、时长与状态等信息。

限制:需预先安装 ffmpeg 与 ffprobe;图片源未指定 --duration 时默认 4 秒;--to-scale 小于 --from-scale 会报错,大于 2.0 会警告可能出现像素化;zoom-punch 的 --at 超出视频长度时按从头应用处理并记录警告;源无音频时输出不含音频流,不算错误。