拓冰网站定制 
OpenMontage 视频制作中的 FFmpeg 实战指南从素材预处理到多平台分发【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontageFFmpeg 是 OpenMontage世界首个开源的 Agentic 视频制作系统中负责视频/音频处理的核心引擎承担格式转换、缩放、压缩、音频提取、变速、拼接等全部非 AI 推理类媒体加工任务。这篇指南完整梳理仓库中 FFmpeg 技能文档 的实操命令并结合 video_trimmer、audio_mixer、color_grade 等工具源码带你掌握面向 Remotion 视频项目与多平台分发的完整 FFmpeg 工作流。一、FFmpeg 在 OpenMontage 中的定位在 OpenMontage 的 Agent 技能体系中FFmpeg 被定义为处理不涉及 AI 推理的任何视频/音频加工的必备工具。仓库的 核心技能文档 明确指出其典型场景包括剪切、修剪、变速、拼接、音频提取、混音、字幕烧录、叠加合成、编码、人脸增强、调色与音频清理。这些能力被封装为一批声明式工具底层全部依赖cmd:ffmpeg核心流水线工具包括工具能力源码位置video_trimmer剪切、修剪、变速、拼接视频片段tools/video/video_trimmer.pyvideo_compose完整合成剪切 字幕 叠加 编码tools/video/video_compose.pyaudio_mixer语音/音乐/SFX 混音、闪避、淡入淡出、音频提取tools/audio/audio_mixer.pyframe_sampler从视频中提取代表帧tools/analysis/frame_sampler.py增强层工具如 color_grade.py 内置cinematic_warm、cinematic_cool、moody_dark等调色档位同样以 FFmpeg 的colorbalance、curves、eq滤镜链实现。例如video_trimmer的speed操作会在源码中构造setpts{1.0/factor}*PTS视频滤镜与串联的atempo音频滤镜video_trimmer.py 第 144-180 行与下文手写命令完全同构。因此掌握本文的命令即掌握这些工具的行为原理。二、Quick Reference高频操作速查2.1 GIF 转 MP4Remotion 兼容格式ffmpeg -i input.gif -movflags faststart -pix_fmt yuv420p \ -vf scaletrunc(iw/2)*2:trunc(ih/2)*2 output.mp4为什么需要这些 flag-movflags faststart将元数据移动到文件头部便于网络流式播放浏览器可边下边播-pix_fmt yuv420p保证与绝大多数播放器兼容许多播放器不支持 yuv444 等高位深格式scaletrunc(iw/2)*2:trunc(ih/2)*2强制宽高为偶数。H.264/H.265 等主流编码器要求宽高可被 2 整除奇数尺寸会导致 Height not divisible by 2 报错。2.2 视频缩放# 缩放到 1920x1080保持宽高比黑边填充 ffmpeg -i input.mp4 -vf scale1920:1080:force_original_aspect_ratiodecrease,pad1920:1080:(ow-iw)/2:(oh-ih)/2 output.mp4 # 缩放到 1920x1080裁切填充会裁掉边缘内容 ffmpeg -i input.mp4 -vf scale1920:1080:force_original_aspect_ratioincrease,crop1920:1080 output.mp4 # 只指定宽度高度自动计算-2 保证偶数 ffmpeg -i input.mp4 -vf scale1280:-2 output.mp4两种策略的区别decrease pad保留完整画面、用黑边补齐目标比例适合演示类素材increase crop填满目标画幅但裁掉部分内容适合封面、短剧等需要满屏的场合。后一个命令里-2是 FFmpeg 的约定——让 ffmpeg 自动计算高度并向下取整到偶数避免奇数尺寸问题。2.3 视频压缩# 高质量、小文件CRF 23 是 libx264 默认值数值越低画质越好 ffmpeg -i input.mp4 -c:v libx264 -crf 23 -preset medium -c:a aac -b:a 128k output.mp4 # Web 预览用激进压缩 ffmpeg -i input.mp4 -c:v libx264 -crf 28 -preset fast -c:a aac -b:a 96k output.mp4 # 按目标文件大小压缩例如 60 秒视频约 10MB ≈ 1.3Mbps ffmpeg -i input.mp4 -c:v libx264 -b:v 1300k -c:a aac -b:a 128k output.mp4CRFConstant Rate Factor是 x264 的质量控制模式恒定视觉质量、码率随内容波动。CRF 每 6 大约使文件体积减半。-preset控制编码速度与压缩率权衡slow更小体积、fast更快。按目标大小压缩时用-b:v指定视频平均码率需结合时长估算。2.4 提取音频# 提取为 MP3-q:a 2 对应 VBR 约 190kbps音质良好 ffmpeg -i input.mp4 -vn -acodec libmp3lame -q:a 2 output.mp3 # 提取为 AAC保留高音质适合继续剪辑 ffmpeg -i input.mp4 -vn -acodec aac -b:a 192k output.m4a # 提取为 WAV无压缩 ffmpeg -i input.mp4 -vn output.wav-vn表示禁用视频轨只保留音频。OpenMontage 的audio_mixer工具即通过 FFmpeg 的extract操作完成同样的提取工作供后续混音与响度归一化使用。2.5 音频格式转换# M4A 转 MP3例如给 ElevenLabs 提供声音样本 ffmpeg -i input.m4a -codec:a libmp3lame -qscale:a 2 output.mp3 # WAV 转 MP3 ffmpeg -i input.wav -codec:a libmp3lame -b:a 192k output.mp3 # 调整音量1.5 倍 ffmpeg -i input.mp3 -filter:a volume1.5 output.mp3注意 MP3 转换的两组参数等价-qscale:a 2与-q:a 2都表示 VBR 质量档位若需要恒定码率则用-b:a。2.6 裁剪/剪切视频# 从时间戳开始、按时长裁剪推荐最可靠 ffmpeg -i input.mp4 -ss 00:00:30 -t 00:00:15 -c:v libx264 -c:a aac output.mp4 # 从时间戳裁剪到时间戳 ffmpeg -i input.mp4 -ss 00:00:30 -to 00:00:45 -c:v libx264 -c:a aac output.mp4 # 流拷贝快但剪切点可能丢帧——仅当源文件关键帧密集时使用 ffmpeg -i input.mp4 -ss 00:00:30 -t 00:00:15 -c copy output.mp4关键提示裁剪推荐重编码。-c copy流拷贝虽然瞬时完成且无损但如果剪切点不对齐关键帧会静默丢帧或出现画面卡顿。OpenMontage 的video_trimmer工具默认codec: copy但允许传入任意编码器video_trimmer.py 第 124-127 行对帧精度要求高的场景应切换为libx264重编码。2.7 变速加速/慢放# 2 倍速视频 音频同步变速 ffmpeg -i input.mp4 -filter_complex [0:v]setpts0.5*PTS[v];[0:a]atempo2.0[a] -map [v] -map [a] output.mp4 # 0.5 倍速慢动作 ffmpeg -i input.mp4 -filter_complex [0:v]setpts2.0*PTS[v];[0:a]atempo0.5[a] -map [v] -map [a] output.mp4 # 仅视频变速丢弃音频 ffmpeg -i input.mp4 -filter:v setpts0.5*PTS -an output.mp4原理拆解视频变速通过setpts修改帧的展示时间戳PTSsetpts 原始时长 / 目标速度音频变速通过atempo滤镜实现。-map将滤镜输出映射到最终文件的音视频轨。video_trimmer的_build_atempo_chainvideo_trimmer.py 第 255-270 行正是针对 atempo 单次只能接受 0.5100.0 倍速的限制用循环串联多个atempo滤镜来支持极端变速。2.8 拼接视频# 创建文件清单 echo file clip1.mp4 list.txt echo file clip2.mp4 list.txt echo file clip3.mp4 list.txt # 拼接同编码/同分辨率无损流拷贝 ffmpeg -f concat -safe 0 -i list.txt -c copy output.mp4 # 拼接 重编码素材来源不同时使用 ffmpeg -f concat -safe 0 -i list.txt -c:v libx264 -c:a aac output.mp4-f concat使用 concat demuxer 按清单顺序拼接-safe 0允许清单中出现绝对路径安全模式下默认拒绝。OpenMontage 的video_trimmerconcat 实现会先把每个片段按-ss/-to裁剪到临时目录再写清单拼接video_trimmer.py 第 182-253 行并自动清理临时文件。经验法则同编码同分辨率用-c copy混合编码或不同分辨率必须先统一重编码。2.9 添加淡入淡出# 视频前 1 秒淡入、第 9 秒起 1 秒淡出以 30fps 视频为例 ffmpeg -i input.mp4 -vf fadetin:st0:d1,fadetout:st9:d1 -c:a copy output.mp4 # 音频淡入淡出 ffmpeg -i input.mp4 -af afadetin:st0:d1,afadetout:st9:d1 -c:v copy output.mp4st为起始秒数d为持续时间。注意视频用-vf、音频用-af互不影响只动其中一轨时另一轨用-c:a copy/-c:v copy保持无损。2.10 获取视频信息# 仅输出时长 ffprobe -v error -show_entries formatduration -of defaultnoprint_wrappers1:nokey1 input.mp4 # 完整信息JSON 格式含所有流 ffprobe -v quiet -print_format json -show_format -show_streams input.mp4ffprobe是 FFmpeg 套件的眼睛任何需要判断素材分辨率、时长、编码、码率的自动化流程包括 OpenMontage 的audio_probe、video_analyzer等工具都依赖它。三、Remotion 特定模式为合成渲染准备素材3.1 FFmpeg 与 RemotionplaybackRate的选型场景用 FFmpeg用 Remotion恒定速度1.5x、2x两者皆可✅ 更简单极端速度4x 或 0.25x✅ 更可靠可能出问题变速随时间加速✅ 预处理需要复杂变通需要完美音画同步✅ 有保证通常没问题Demo 需匹配旁白节奏✅ 预先计算运行时调整Remotion 的局限playbackRate必须是常量。类似playbackRate{interpolate(frame, [0, 100], [1, 5])}的动态插值无法正确工作因为 Remotion 会独立求值每一帧。这正是把变速需求前置到 FFmpeg 的根本原因。3.2 变速公式速查把 X 秒视频塞进 Y 秒场景speed X / Ysetpts系数 1 / speed如 3 倍速 →setpts0.333*PTSatempo值 speed如 3 倍速 →atempo3.0# 60 秒 demo 压缩进 20 秒场景3 倍速 ffmpeg -i demo-raw.mp4 \ -filter_complex [0:v]setpts0.333*PTS[v];[0:a]atempo3.0[a] \ -map [v] -map [a] \ public/demos/demo-fast.mp4 # 0.5 倍慢动作强调 ffmpeg -i action.mp4 \ -filter_complex [0:v]setpts2.0*PTS[v];[0:a]atempo0.5[a] \ -map [v] -map [a] \ public/demos/action-slow.mp4 # 无音频加速屏幕录制常见 ffmpeg -i demo.mp4 -filter:v setpts0.5*PTS -an public/demos/demo-2x.mp4 # 延时摄影效果10 倍速丢弃音频 ffmpeg -i long-demo.mp4 -filter:v setpts0.1*PTS -an public/demos/timelapse.mp4极端速度音频 2x需要串联 atempo每个atempo滤镜只能接受 0.52.0 的倍率范围超过必须链式串联# 4 倍速音频 -filter_complex [0:a]atempo2.0,atempo2.0[a] # 8 倍速音频 -filter_complex [0:a]atempo2.0,atempo2.0,atempo2.0[a]仓库中的video_trimmer正是用 同样的串联算法 支持最高 100 倍速的音频处理二者思路完全一致。3.3 将 Demo 录制标准化为 Remotion 素材# 标准 1080p、30fps、Remotion 就绪 ffmpeg -i raw-recording.mp4 \ -vf scale1920:1080:force_original_aspect_ratiodecrease,pad1920:1080:(ow-iw)/2:(oh-ih)/2,fps30 \ -c:v libx264 -crf 18 -preset slow \ -c:a aac -b:a 192k \ -movflags faststart \ public/demos/demo.mp4这里fps30把可变帧率VFR统一为恒定 30fpscrf 18 preset slow保证高质量母版。Remotion 合成时帧号与时间戳的对应关系依赖恒定帧率这一步是避免音画漂移的关键。3.4 手机屏幕录制转 Remotion 素材# iPhone/iPad 录制通常是 60fps、分辨率不固定 ffmpeg -i iphone-recording.mov \ -vf scale1920:-2,fps30 \ -c:v libx264 -crf 20 \ -an \ public/demos/mobile-demo.mp4-an丢弃原声屏幕录制往往含环境噪音静音素材后续由 Remotion 或audio_mixer配乐。3.5 批量转换 GIFfor f in assets/*.gif; do ffmpeg -i $f -movflags faststart -pix_fmt yuv420p \ -vf scaletrunc(iw/2)*2:trunc(ih/2)*2 \ public/demos/$(basename $f .gif).mp4 done这段 shell 循环把assets/下所有 GIF 批量转为同名 MP4 输出到public/demos/是素材入库前的一次性清洗操作。四、常见问题速查症状原因修复Height not divisible by 2宽高为奇数加缩放滤镜-vf scaletrunc(iw/2)*2:trunc(ih/2)*2浏览器无法播放编码/像素格式不兼容使用-movflags faststart -pix_fmt yuv420p -c:v libx264变速后音画不同步音频用了错误的处理方式用 filter_complex atempo-filter_complex [0:v]setpts0.5*PTS[v];[0:a]atempo2.0[a]文件过大码率/CRF 过高提高 CRF23→28或降低分辨率五、质量指南CRF 与 Preset 选择表用途CRFPreset说明归档/母版18slow最佳画质文件最大成片交付20-22medium质量与体积均衡Web/预览23-25fast文件更小草稿/快速28veryfast编码最快这一质量分级与 核心技能文档 的约定一致默认 CRF 23最终交付物建议 18-20。同一原则也贯穿在video_compose的encode_profile能力中——只有需要保持无损时才用-c copy仅剪切/拼接不改帧任何应用滤镜变速、字幕、叠加、缩放的操作都必须重编码。六、平台特定输出优化Remotion 渲染之后Remotion 渲染出母版通常输出到out/video.mp4之后用 FFmpeg 为每个分发平台生成独立优化版本Remotion render (master) FFmpeg optimization Platform upload ↓ ↓ ↓ out/video.mp4 ────────→ out/video-youtube.mp4 ───→ YouTube ────────→ out/video-twitter.mp4 ───→ Twitter/X ────────→ out/video-linkedin.mp4 ───→ LinkedIn ────────→ out/video-web.mp4 ───→ Website embed6.1 YouTube推荐设置YouTube 会对所有上传视频重新编码因此上传高质量母版即可# YouTube 优化版1080p ffmpeg -i out/video.mp4 \ -c:v libx264 -preset slow -crf 18 \ -profile:v high -level 4.0 \ -bf 2 -g 30 \ -c:a aac -b:a 192k -ar 48000 \ -movflags faststart \ out/video-youtube.mp4 # YouTube Shorts竖屏 1080x1920 ffmpeg -i out/video.mp4 \ -vf scale1080:1920:force_original_aspect_ratiodecrease,pad1080:1920:(ow-iw)/2:(oh-ih)/2 \ -c:v libx264 -crf 18 -c:a aac -b:a 192k \ out/video-shorts.mp4-bf 2启用 B 帧、-g 30每 30 帧一个 GOP-ar 48000对应平台要求的 48kHz 采样率。6.2 Twitter/XTwitter 限制严格最长 140 秒、最大 512MB、最大 1920x1200# Twitter 优化版目标 15MB 以下快速上传 ffmpeg -i out/video.mp4 \ -c:v libx264 -preset medium -crf 24 \ -profile:v main -level 3.1 \ -vf scalemin(1280,iw):min(720,ih):force_original_aspect_ratiodecrease \ -c:a aac -b:a 128k -ar 44100 \ -movflags faststart \ -fs 15M \ out/video-twitter.mp4 # 校验文件大小与时长 ffprobe -v error -show_entries formatduration,size -of csvp0 out/video-twitter.mp4-fs 15M是文件大小硬上限超过即终止写入-ar 44100匹配平台 44.1kHz 音频要求。6.3 LinkedInLinkedIn 偏好 MP4 AAC 音频最长 10 分钟# LinkedIn 优化版 ffmpeg -i out/video.mp4 \ -c:v libx264 -preset medium -crf 22 \ -profile:v main \ -vf scalemin(1920,iw):min(1080,ih):force_original_aspect_ratiodecrease \ -c:a aac -b:a 192k -ar 48000 \ -movflags faststart \ out/video-linkedin.mp46.4 网站/嵌入快速加载# Web 优化 MP4小文件、渐进加载 ffmpeg -i out/video.mp4 \ -c:v libx264 -preset medium -crf 26 \ -profile:v baseline -level 3.0 \ -vf scale1280:720 \ -c:a aac -b:a 128k \ -movflags faststart \ out/video-web.mp4 # WebM 备选压缩率更高现代浏览器支持广 ffmpeg -i out/video.mp4 \ -c:v libvpx-vp9 -crf 30 -b:v 0 \ -vf scale1280:720 \ -c:a libopus -b:a 128k \ -deadline good \ out/video-web.webmWebM 用 VP9 Opus 组合-crf 30 -b:v 0是 VP9 的恒定质量模式注意与 x264 的 CRF 语义不同-deadline good控制编码速度。6.5 GIF预览/缩略图# 高质量 GIF取前 5 秒 ffmpeg -i out/video.mp4 -t 5 \ -vf fps15,scale480:-1:flagslanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse \ out/preview.gif # 更小体积的 GIF ffmpeg -i out/video.mp4 -t 3 \ -vf fps10,scale320:-1:flagslanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse \ out/preview-small.gif这段滤镜链是 GIF 的两步调色板法先palettegen从采样帧生成全局调色板再paletteuse应用调色板量化输出——这是避免 GIF 出现色带的业界标准做法。6.6 平台要求速查表平台最大分辨率最大大小最大时长音频YouTube8K256GB12 小时AAC 48kHzTwitter/X1920x1200512MB140 秒AAC 44.1kHzLinkedIn4096x23045GB10 分钟AAC 48kHzInstagram Feed1080x13504GB60 秒AAC 48kHzInstagram Reels1080x19204GB90 秒AAC 48kHzTikTok1080x1920287MB10 分钟AAC6.7 一键批量导出所有平台将以下脚本保存为export-all-platforms.sh并赋予执行权限即可从单一母版产出全部平台版本#!/bin/bash # save as: export-all-platforms.sh INPUTout/video.mp4 # YouTube (high quality) ffmpeg -i $INPUT -c:v libx264 -preset slow -crf 18 \ -c:a aac -b:a 192k -movflags faststart \ out/video-youtube.mp4 # Twitter (compressed) ffmpeg -i $INPUT -c:v libx264 -crf 24 \ -vf scalemin(1280,iw):-2 \ -c:a aac -b:a 128k -movflags faststart \ out/video-twitter.mp4 # LinkedIn ffmpeg -i $INPUT -c:v libx264 -crf 22 \ -c:a aac -b:a 192k -movflags faststart \ out/video-linkedin.mp4 # Web embed (small) ffmpeg -i $INPUT -c:v libx264 -crf 26 \ -vf scale1280:720 \ -c:a aac -b:a 128k -movflags faststart \ out/video-web.mp4 echo Exported: ls -lh out/video-*.mp4七、错误处理与输出校验7.1 执行结果判断与文件校验# 检查 FFmpeg 是否成功 ffmpeg -i input.mp4 -c:v libx264 output.mp4 echo Success || echo Failed: check input file # 校验输出文件可播放读取视频流编码信息 ffprobe -v error -select_streams v:0 -show_entries streamcodec_name -of csvp0 output.mp4 # 获取详细错误信息前 20 行 ffmpeg -v error -i input.mp4 -f null - 21 | head -20第三个命令用-f null做完整解码演练而不产出文件是定位解码错误的常用手段。7.2 常见失败对照表错误原因修复No such file输入路径错误检查路径路径含空格时加引号Invalid data输入文件损坏重新下载或重新录制源素材height not divisible by 2宽高为奇数添加带 trunc 的 scale 滤镜encoder not found缺少编码器安装完整版 FFmpeg输出 0 字节静默失败查看完整 ffmpeg 输出定位错误八、扩展阅读与技能体系FFmpeg 只是 OpenMontage 700 技能文件中的一员。若需进一步深入技能源文件.claude/skills/ffmpeg/SKILL.md本文全部命令的原始出处工程化封装skills/core/ffmpeg.md 规定了字幕烧录优先 SRT、force_style使用完整 ASS 颜色H00FFFFFF、竖屏font_size: 18且每句最多 3 词、音频闪避sidechaincompress典型参数threshold0.02, ratio9, attack200ms, release500ms、调色强度intensity: 0.85为 talking head 推荐值等进阶约定工具实现阅读 video_trimmer.py、audio_mixer.py、video_compose.py、color_grade.py 可了解这些命令如何在 Agent 工具层被声明式调用测试验证仓库的 tests/qa/test_04_audio_mix.py、tests/qa/test_05_video_compose.py、tests/qa/test_06_video_stitch.py 等 QA 用例持续校验 FFmpeg 流水线的输出质量。掌握本文的 FFmpeg 技能树你就能在 OpenMontage 的 Agentic 视频流水线中独立完成从素材清洗、Remotion 素材准备到多平台分发的全部媒体工程环节。【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OpenMontage 视频制作中的 FFmpeg 实战指南：从素材预处理到多平台分发
OpenMontage 视频制作中的 FFmpeg 实战指南从素材预处理到多平台分发【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontageFFmpeg 是 OpenMontage世界首个开源的 Agentic 视频制作系统中负责视频/音频处理的核心引擎承担格式转换、缩放、压缩、音频提取、变速、拼接等全部非 AI 推理类媒体加工任务。这篇指南完整梳理仓库中 FFmpeg 技能文档 的实操命令并结合 video_trimmer、audio_mixer、color_grade 等工具源码带你掌握面向 Remotion 视频项目与多平台分发的完整 FFmpeg 工作流。一、FFmpeg 在 OpenMontage 中的定位在 OpenMontage 的 Agent 技能体系中FFmpeg 被定义为处理不涉及 AI 推理的任何视频/音频加工的必备工具。仓库的 核心技能文档 明确指出其典型场景包括剪切、修剪、变速、拼接、音频提取、混音、字幕烧录、叠加合成、编码、人脸增强、调色与音频清理。这些能力被封装为一批声明式工具底层全部依赖cmd:ffmpeg核心流水线工具包括工具能力源码位置video_trimmer剪切、修剪、变速、拼接视频片段tools/video/video_trimmer.pyvideo_compose完整合成剪切 字幕 叠加 编码tools/video/video_compose.pyaudio_mixer语音/音乐/SFX 混音、闪避、淡入淡出、音频提取tools/audio/audio_mixer.pyframe_sampler从视频中提取代表帧tools/analysis/frame_sampler.py增强层工具如 color_grade.py 内置cinematic_warm、cinematic_cool、moody_dark等调色档位同样以 FFmpeg 的colorbalance、curves、eq滤镜链实现。例如video_trimmer的speed操作会在源码中构造setpts{1.0/factor}*PTS视频滤镜与串联的atempo音频滤镜video_trimmer.py 第 144-180 行与下文手写命令完全同构。因此掌握本文的命令即掌握这些工具的行为原理。二、Quick Reference高频操作速查2.1 GIF 转 MP4Remotion 兼容格式ffmpeg -i input.gif -movflags faststart -pix_fmt yuv420p \ -vf scaletrunc(iw/2)*2:trunc(ih/2)*2 output.mp4为什么需要这些 flag-movflags faststart将元数据移动到文件头部便于网络流式播放浏览器可边下边播-pix_fmt yuv420p保证与绝大多数播放器兼容许多播放器不支持 yuv444 等高位深格式scaletrunc(iw/2)*2:trunc(ih/2)*2强制宽高为偶数。H.264/H.265 等主流编码器要求宽高可被 2 整除奇数尺寸会导致 Height not divisible by 2 报错。2.2 视频缩放# 缩放到 1920x1080保持宽高比黑边填充 ffmpeg -i input.mp4 -vf scale1920:1080:force_original_aspect_ratiodecrease,pad1920:1080:(ow-iw)/2:(oh-ih)/2 output.mp4 # 缩放到 1920x1080裁切填充会裁掉边缘内容 ffmpeg -i input.mp4 -vf scale1920:1080:force_original_aspect_ratioincrease,crop1920:1080 output.mp4 # 只指定宽度高度自动计算-2 保证偶数 ffmpeg -i input.mp4 -vf scale1280:-2 output.mp4两种策略的区别decrease pad保留完整画面、用黑边补齐目标比例适合演示类素材increase crop填满目标画幅但裁掉部分内容适合封面、短剧等需要满屏的场合。后一个命令里-2是 FFmpeg 的约定——让 ffmpeg 自动计算高度并向下取整到偶数避免奇数尺寸问题。2.3 视频压缩# 高质量、小文件CRF 23 是 libx264 默认值数值越低画质越好 ffmpeg -i input.mp4 -c:v libx264 -crf 23 -preset medium -c:a aac -b:a 128k output.mp4 # Web 预览用激进压缩 ffmpeg -i input.mp4 -c:v libx264 -crf 28 -preset fast -c:a aac -b:a 96k output.mp4 # 按目标文件大小压缩例如 60 秒视频约 10MB ≈ 1.3Mbps ffmpeg -i input.mp4 -c:v libx264 -b:v 1300k -c:a aac -b:a 128k output.mp4CRFConstant Rate Factor是 x264 的质量控制模式恒定视觉质量、码率随内容波动。CRF 每 6 大约使文件体积减半。-preset控制编码速度与压缩率权衡slow更小体积、fast更快。按目标大小压缩时用-b:v指定视频平均码率需结合时长估算。2.4 提取音频# 提取为 MP3-q:a 2 对应 VBR 约 190kbps音质良好 ffmpeg -i input.mp4 -vn -acodec libmp3lame -q:a 2 output.mp3 # 提取为 AAC保留高音质适合继续剪辑 ffmpeg -i input.mp4 -vn -acodec aac -b:a 192k output.m4a # 提取为 WAV无压缩 ffmpeg -i input.mp4 -vn output.wav-vn表示禁用视频轨只保留音频。OpenMontage 的audio_mixer工具即通过 FFmpeg 的extract操作完成同样的提取工作供后续混音与响度归一化使用。2.5 音频格式转换# M4A 转 MP3例如给 ElevenLabs 提供声音样本 ffmpeg -i input.m4a -codec:a libmp3lame -qscale:a 2 output.mp3 # WAV 转 MP3 ffmpeg -i input.wav -codec:a libmp3lame -b:a 192k output.mp3 # 调整音量1.5 倍 ffmpeg -i input.mp3 -filter:a volume1.5 output.mp3注意 MP3 转换的两组参数等价-qscale:a 2与-q:a 2都表示 VBR 质量档位若需要恒定码率则用-b:a。2.6 裁剪/剪切视频# 从时间戳开始、按时长裁剪推荐最可靠 ffmpeg -i input.mp4 -ss 00:00:30 -t 00:00:15 -c:v libx264 -c:a aac output.mp4 # 从时间戳裁剪到时间戳 ffmpeg -i input.mp4 -ss 00:00:30 -to 00:00:45 -c:v libx264 -c:a aac output.mp4 # 流拷贝快但剪切点可能丢帧——仅当源文件关键帧密集时使用 ffmpeg -i input.mp4 -ss 00:00:30 -t 00:00:15 -c copy output.mp4关键提示裁剪推荐重编码。-c copy流拷贝虽然瞬时完成且无损但如果剪切点不对齐关键帧会静默丢帧或出现画面卡顿。OpenMontage 的video_trimmer工具默认codec: copy但允许传入任意编码器video_trimmer.py 第 124-127 行对帧精度要求高的场景应切换为libx264重编码。2.7 变速加速/慢放# 2 倍速视频 音频同步变速 ffmpeg -i input.mp4 -filter_complex [0:v]setpts0.5*PTS[v];[0:a]atempo2.0[a] -map [v] -map [a] output.mp4 # 0.5 倍速慢动作 ffmpeg -i input.mp4 -filter_complex [0:v]setpts2.0*PTS[v];[0:a]atempo0.5[a] -map [v] -map [a] output.mp4 # 仅视频变速丢弃音频 ffmpeg -i input.mp4 -filter:v setpts0.5*PTS -an output.mp4原理拆解视频变速通过setpts修改帧的展示时间戳PTSsetpts 原始时长 / 目标速度音频变速通过atempo滤镜实现。-map将滤镜输出映射到最终文件的音视频轨。video_trimmer的_build_atempo_chainvideo_trimmer.py 第 255-270 行正是针对 atempo 单次只能接受 0.5100.0 倍速的限制用循环串联多个atempo滤镜来支持极端变速。2.8 拼接视频# 创建文件清单 echo file clip1.mp4 list.txt echo file clip2.mp4 list.txt echo file clip3.mp4 list.txt # 拼接同编码/同分辨率无损流拷贝 ffmpeg -f concat -safe 0 -i list.txt -c copy output.mp4 # 拼接 重编码素材来源不同时使用 ffmpeg -f concat -safe 0 -i list.txt -c:v libx264 -c:a aac output.mp4-f concat使用 concat demuxer 按清单顺序拼接-safe 0允许清单中出现绝对路径安全模式下默认拒绝。OpenMontage 的video_trimmerconcat 实现会先把每个片段按-ss/-to裁剪到临时目录再写清单拼接video_trimmer.py 第 182-253 行并自动清理临时文件。经验法则同编码同分辨率用-c copy混合编码或不同分辨率必须先统一重编码。2.9 添加淡入淡出# 视频前 1 秒淡入、第 9 秒起 1 秒淡出以 30fps 视频为例 ffmpeg -i input.mp4 -vf fadetin:st0:d1,fadetout:st9:d1 -c:a copy output.mp4 # 音频淡入淡出 ffmpeg -i input.mp4 -af afadetin:st0:d1,afadetout:st9:d1 -c:v copy output.mp4st为起始秒数d为持续时间。注意视频用-vf、音频用-af互不影响只动其中一轨时另一轨用-c:a copy/-c:v copy保持无损。2.10 获取视频信息# 仅输出时长 ffprobe -v error -show_entries formatduration -of defaultnoprint_wrappers1:nokey1 input.mp4 # 完整信息JSON 格式含所有流 ffprobe -v quiet -print_format json -show_format -show_streams input.mp4ffprobe是 FFmpeg 套件的眼睛任何需要判断素材分辨率、时长、编码、码率的自动化流程包括 OpenMontage 的audio_probe、video_analyzer等工具都依赖它。三、Remotion 特定模式为合成渲染准备素材3.1 FFmpeg 与 RemotionplaybackRate的选型场景用 FFmpeg用 Remotion恒定速度1.5x、2x两者皆可✅ 更简单极端速度4x 或 0.25x✅ 更可靠可能出问题变速随时间加速✅ 预处理需要复杂变通需要完美音画同步✅ 有保证通常没问题Demo 需匹配旁白节奏✅ 预先计算运行时调整Remotion 的局限playbackRate必须是常量。类似playbackRate{interpolate(frame, [0, 100], [1, 5])}的动态插值无法正确工作因为 Remotion 会独立求值每一帧。这正是把变速需求前置到 FFmpeg 的根本原因。3.2 变速公式速查把 X 秒视频塞进 Y 秒场景speed X / Ysetpts系数 1 / speed如 3 倍速 →setpts0.333*PTSatempo值 speed如 3 倍速 →atempo3.0# 60 秒 demo 压缩进 20 秒场景3 倍速 ffmpeg -i demo-raw.mp4 \ -filter_complex [0:v]setpts0.333*PTS[v];[0:a]atempo3.0[a] \ -map [v] -map [a] \ public/demos/demo-fast.mp4 # 0.5 倍慢动作强调 ffmpeg -i action.mp4 \ -filter_complex [0:v]setpts2.0*PTS[v];[0:a]atempo0.5[a] \ -map [v] -map [a] \ public/demos/action-slow.mp4 # 无音频加速屏幕录制常见 ffmpeg -i demo.mp4 -filter:v setpts0.5*PTS -an public/demos/demo-2x.mp4 # 延时摄影效果10 倍速丢弃音频 ffmpeg -i long-demo.mp4 -filter:v setpts0.1*PTS -an public/demos/timelapse.mp4极端速度音频 2x需要串联 atempo每个atempo滤镜只能接受 0.52.0 的倍率范围超过必须链式串联# 4 倍速音频 -filter_complex [0:a]atempo2.0,atempo2.0[a] # 8 倍速音频 -filter_complex [0:a]atempo2.0,atempo2.0,atempo2.0[a]仓库中的video_trimmer正是用 同样的串联算法 支持最高 100 倍速的音频处理二者思路完全一致。3.3 将 Demo 录制标准化为 Remotion 素材# 标准 1080p、30fps、Remotion 就绪 ffmpeg -i raw-recording.mp4 \ -vf scale1920:1080:force_original_aspect_ratiodecrease,pad1920:1080:(ow-iw)/2:(oh-ih)/2,fps30 \ -c:v libx264 -crf 18 -preset slow \ -c:a aac -b:a 192k \ -movflags faststart \ public/demos/demo.mp4这里fps30把可变帧率VFR统一为恒定 30fpscrf 18 preset slow保证高质量母版。Remotion 合成时帧号与时间戳的对应关系依赖恒定帧率这一步是避免音画漂移的关键。3.4 手机屏幕录制转 Remotion 素材# iPhone/iPad 录制通常是 60fps、分辨率不固定 ffmpeg -i iphone-recording.mov \ -vf scale1920:-2,fps30 \ -c:v libx264 -crf 20 \ -an \ public/demos/mobile-demo.mp4-an丢弃原声屏幕录制往往含环境噪音静音素材后续由 Remotion 或audio_mixer配乐。3.5 批量转换 GIFfor f in assets/*.gif; do ffmpeg -i $f -movflags faststart -pix_fmt yuv420p \ -vf scaletrunc(iw/2)*2:trunc(ih/2)*2 \ public/demos/$(basename $f .gif).mp4 done这段 shell 循环把assets/下所有 GIF 批量转为同名 MP4 输出到public/demos/是素材入库前的一次性清洗操作。四、常见问题速查症状原因修复Height not divisible by 2宽高为奇数加缩放滤镜-vf scaletrunc(iw/2)*2:trunc(ih/2)*2浏览器无法播放编码/像素格式不兼容使用-movflags faststart -pix_fmt yuv420p -c:v libx264变速后音画不同步音频用了错误的处理方式用 filter_complex atempo-filter_complex [0:v]setpts0.5*PTS[v];[0:a]atempo2.0[a]文件过大码率/CRF 过高提高 CRF23→28或降低分辨率五、质量指南CRF 与 Preset 选择表用途CRFPreset说明归档/母版18slow最佳画质文件最大成片交付20-22medium质量与体积均衡Web/预览23-25fast文件更小草稿/快速28veryfast编码最快这一质量分级与 核心技能文档 的约定一致默认 CRF 23最终交付物建议 18-20。同一原则也贯穿在video_compose的encode_profile能力中——只有需要保持无损时才用-c copy仅剪切/拼接不改帧任何应用滤镜变速、字幕、叠加、缩放的操作都必须重编码。六、平台特定输出优化Remotion 渲染之后Remotion 渲染出母版通常输出到out/video.mp4之后用 FFmpeg 为每个分发平台生成独立优化版本Remotion render (master) FFmpeg optimization Platform upload ↓ ↓ ↓ out/video.mp4 ────────→ out/video-youtube.mp4 ───→ YouTube ────────→ out/video-twitter.mp4 ───→ Twitter/X ────────→ out/video-linkedin.mp4 ───→ LinkedIn ────────→ out/video-web.mp4 ───→ Website embed6.1 YouTube推荐设置YouTube 会对所有上传视频重新编码因此上传高质量母版即可# YouTube 优化版1080p ffmpeg -i out/video.mp4 \ -c:v libx264 -preset slow -crf 18 \ -profile:v high -level 4.0 \ -bf 2 -g 30 \ -c:a aac -b:a 192k -ar 48000 \ -movflags faststart \ out/video-youtube.mp4 # YouTube Shorts竖屏 1080x1920 ffmpeg -i out/video.mp4 \ -vf scale1080:1920:force_original_aspect_ratiodecrease,pad1080:1920:(ow-iw)/2:(oh-ih)/2 \ -c:v libx264 -crf 18 -c:a aac -b:a 192k \ out/video-shorts.mp4-bf 2启用 B 帧、-g 30每 30 帧一个 GOP-ar 48000对应平台要求的 48kHz 采样率。6.2 Twitter/XTwitter 限制严格最长 140 秒、最大 512MB、最大 1920x1200# Twitter 优化版目标 15MB 以下快速上传 ffmpeg -i out/video.mp4 \ -c:v libx264 -preset medium -crf 24 \ -profile:v main -level 3.1 \ -vf scalemin(1280,iw):min(720,ih):force_original_aspect_ratiodecrease \ -c:a aac -b:a 128k -ar 44100 \ -movflags faststart \ -fs 15M \ out/video-twitter.mp4 # 校验文件大小与时长 ffprobe -v error -show_entries formatduration,size -of csvp0 out/video-twitter.mp4-fs 15M是文件大小硬上限超过即终止写入-ar 44100匹配平台 44.1kHz 音频要求。6.3 LinkedInLinkedIn 偏好 MP4 AAC 音频最长 10 分钟# LinkedIn 优化版 ffmpeg -i out/video.mp4 \ -c:v libx264 -preset medium -crf 22 \ -profile:v main \ -vf scalemin(1920,iw):min(1080,ih):force_original_aspect_ratiodecrease \ -c:a aac -b:a 192k -ar 48000 \ -movflags faststart \ out/video-linkedin.mp46.4 网站/嵌入快速加载# Web 优化 MP4小文件、渐进加载 ffmpeg -i out/video.mp4 \ -c:v libx264 -preset medium -crf 26 \ -profile:v baseline -level 3.0 \ -vf scale1280:720 \ -c:a aac -b:a 128k \ -movflags faststart \ out/video-web.mp4 # WebM 备选压缩率更高现代浏览器支持广 ffmpeg -i out/video.mp4 \ -c:v libvpx-vp9 -crf 30 -b:v 0 \ -vf scale1280:720 \ -c:a libopus -b:a 128k \ -deadline good \ out/video-web.webmWebM 用 VP9 Opus 组合-crf 30 -b:v 0是 VP9 的恒定质量模式注意与 x264 的 CRF 语义不同-deadline good控制编码速度。6.5 GIF预览/缩略图# 高质量 GIF取前 5 秒 ffmpeg -i out/video.mp4 -t 5 \ -vf fps15,scale480:-1:flagslanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse \ out/preview.gif # 更小体积的 GIF ffmpeg -i out/video.mp4 -t 3 \ -vf fps10,scale320:-1:flagslanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse \ out/preview-small.gif这段滤镜链是 GIF 的两步调色板法先palettegen从采样帧生成全局调色板再paletteuse应用调色板量化输出——这是避免 GIF 出现色带的业界标准做法。6.6 平台要求速查表平台最大分辨率最大大小最大时长音频YouTube8K256GB12 小时AAC 48kHzTwitter/X1920x1200512MB140 秒AAC 44.1kHzLinkedIn4096x23045GB10 分钟AAC 48kHzInstagram Feed1080x13504GB60 秒AAC 48kHzInstagram Reels1080x19204GB90 秒AAC 48kHzTikTok1080x1920287MB10 分钟AAC6.7 一键批量导出所有平台将以下脚本保存为export-all-platforms.sh并赋予执行权限即可从单一母版产出全部平台版本#!/bin/bash # save as: export-all-platforms.sh INPUTout/video.mp4 # YouTube (high quality) ffmpeg -i $INPUT -c:v libx264 -preset slow -crf 18 \ -c:a aac -b:a 192k -movflags faststart \ out/video-youtube.mp4 # Twitter (compressed) ffmpeg -i $INPUT -c:v libx264 -crf 24 \ -vf scalemin(1280,iw):-2 \ -c:a aac -b:a 128k -movflags faststart \ out/video-twitter.mp4 # LinkedIn ffmpeg -i $INPUT -c:v libx264 -crf 22 \ -c:a aac -b:a 192k -movflags faststart \ out/video-linkedin.mp4 # Web embed (small) ffmpeg -i $INPUT -c:v libx264 -crf 26 \ -vf scale1280:720 \ -c:a aac -b:a 128k -movflags faststart \ out/video-web.mp4 echo Exported: ls -lh out/video-*.mp4七、错误处理与输出校验7.1 执行结果判断与文件校验# 检查 FFmpeg 是否成功 ffmpeg -i input.mp4 -c:v libx264 output.mp4 echo Success || echo Failed: check input file # 校验输出文件可播放读取视频流编码信息 ffprobe -v error -select_streams v:0 -show_entries streamcodec_name -of csvp0 output.mp4 # 获取详细错误信息前 20 行 ffmpeg -v error -i input.mp4 -f null - 21 | head -20第三个命令用-f null做完整解码演练而不产出文件是定位解码错误的常用手段。7.2 常见失败对照表错误原因修复No such file输入路径错误检查路径路径含空格时加引号Invalid data输入文件损坏重新下载或重新录制源素材height not divisible by 2宽高为奇数添加带 trunc 的 scale 滤镜encoder not found缺少编码器安装完整版 FFmpeg输出 0 字节静默失败查看完整 ffmpeg 输出定位错误八、扩展阅读与技能体系FFmpeg 只是 OpenMontage 700 技能文件中的一员。若需进一步深入技能源文件.claude/skills/ffmpeg/SKILL.md本文全部命令的原始出处工程化封装skills/core/ffmpeg.md 规定了字幕烧录优先 SRT、force_style使用完整 ASS 颜色H00FFFFFF、竖屏font_size: 18且每句最多 3 词、音频闪避sidechaincompress典型参数threshold0.02, ratio9, attack200ms, release500ms、调色强度intensity: 0.85为 talking head 推荐值等进阶约定工具实现阅读 video_trimmer.py、audio_mixer.py、video_compose.py、color_grade.py 可了解这些命令如何在 Agent 工具层被声明式调用测试验证仓库的 tests/qa/test_04_audio_mix.py、tests/qa/test_05_video_compose.py、tests/qa/test_06_video_stitch.py 等 QA 用例持续校验 FFmpeg 流水线的输出质量。掌握本文的 FFmpeg 技能树你就能在 OpenMontage 的 Agentic 视频流水线中独立完成从素材清洗、Remotion 素材准备到多平台分发的全部媒体工程环节。【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考