SuperAPI AI 工具集

render-edl

通用与其它

查看项目

更新于 10-15 21:54

技能介绍

用途:将 edl.json(剪辑决策表)确定性执行并渲染为成片 master.mp4。EDL 编码剪辑顺序、节奏、转场、音频混音与字幕等决策,本工具负责装配步骤,无交互提示。

主要能力:支持两种来源模式——conform(source.mode="file",用 ffmpeg 从已有视频按 in/out 帧精确裁剪)与 generative(source.mode="generate",在 <project_dir>/clips/<id>.mp4 查找预渲染片段,缺失则列出全部缺失资产并失败)。可应用变速(setpts 与链式 atempo)、运动效果(zoom-punch 阶梯裁剪缩放、push-in 渐变 zoompan)、统一缩放至 1080x1920 或 meta.aspect 对应分辨率、硬切拼接、构建音频床(music + vo + 按时间轴放置的 SFX + 静音节拍,ducking 为 sidechain-20:1 时用 sidechaincompress)、按 caption-style-presets.json 预设烧录 ASS 字幕(static-sentence 与 karaoke-pop),最后混流输出并写 manifest.json。

使用方式:命令行运行 python3 skills/atoms/assembly/render-edl/scripts/render_edl.py --edl <edl.json> --output <master.mp4> [--project-dir <dir>] [--crf 18]。edl 与 output 必填,project_dir 可选(默认取 EDL 的 meta.project_dir,回退到 edl.json 所在目录),crf 默认 18。

适用场景:需要按既定 EDL 可复现地批量装配竖屏短视频成片,并输出运行清单与节奏曲线。

限制:v1 中非硬切 transition_in 一律按硬切处理并记入 manifest;EDL 校验要求时间轴非空且连续、恰有一个 payoff-hold、target_duration 与末片段误差在 ±0.5s 内;变速 <0.1 或 >8.0 被拒;无任何音频时输出静音轨并警告;字幕预设缺失回退 platform-default;需已安装 ffmpeg(brew install ffmpeg 或 apt install ffmpeg)。