SuperAPI AI 工具集

video-assemble

设计与创作

查看项目

更新于 10-16 05:04

技能介绍

用途:作为视频解说流程的最终合成阶段,把已生成的旁白音频放到视频时间线上,混音、生成字幕、做响度交付标准化,输出 recap 成片与字幕文件。

主要能力:在旁白窗口内用固定包络压低原声、间隙恢复;按旁白位置生成 subtitles.srt,默认同时生成并烧录 subtitles.ass;可选两遍 loudnorm 响度标准化到目标 LUFS,含真峰值限幅与解码后实测校验;输出 timeline.json 等多轨模型与 QC 记录;可用 --export-jianying 导出可编辑剪映草稿。

使用方式:运行 python3 scripts/assemble.py <video> --work-dir <work_dir>,可加 --audio-mode narration|source-mix|adopted-packet-copy、--tts-meta、--narration-adoption、--audio-mix-adoption、--output-dir、--no-burn-subtitles、--source-video、--export-jianying 等参数。默认 narration 模式需 work_dir/tts_meta.json。

输出:recap_<stem>.mp4、work_dir/output.mp4、subtitles.srt、timeline.json、placed*.wav、narration_input_binding.json、audio_mix_binding.json、assembly_manifest.json、assembly_qc.json 等。

限制:不生成旁白文字、不合成 TTS、不重新转写视频;烧录字幕需带 subtitles/libass 的 ffmpeg,显式要求烧录时缺失即失败,默认开启时可降级为外挂 srt;文字叠加需 drawtext;剪映导出只接受 schema_version: 2 的 timeline.json,变速、转场、蒙版等扩展字段会被拒绝;已采用配音 v1 合同只支持原速,放不下即 no_safe_fit 而不裁尾。