如何用FFmpeg生成视频缩略图？
视频缩略图是视频平台、内容管理系统和媒体处理流水线的基础功能。从简单的单帧截取到智能选帧、网格拼图，FFmpeg 提供了完整的工具链。理解各参数的行为差异，才能在不同场景下产出高质量的缩略图。
-ss 参数的位置决定性能和精度
-ss 放在 -i 前后，行为完全不同：
# -ss 在 -i 之后：先解码再跳转，慢但精确 ffmpeg -i input.mp4 -ss 00:00:05 -vframes 1 output.jpg # -ss 在 -i 之前：先跳转再解码，快但可能偏移到最近关键帧 ffmpeg -ss 00:00:05 -i input.mp4 -vframes 1 output.jpg
| 位置 | 速度 | 精度 | 适用场景 |
|---|---|---|---|
-ss 在 -i 前 | 快 | 低（跳到最近关键帧） | 快速预览、批量处理 |
-ss 在 -i 后 | 慢 | 高（逐帧定位） | 精确截帧、封面选取 |
生产环境推荐折中方案——两段式 seek：先快速跳到目标前几秒的关键帧，再精确偏移：
ffmpeg -ss 00:00:03 -i input.mp4 -ss 2 -vframes 1 output.jpg
第一个 -ss 快速跳到 3 秒附近的关键帧，第二个 -ss 2 从该位置精确偏移 2 秒到第 5 秒，兼顾速度和精度。
单张缩略图：基础截帧
最简命令提取指定时间点的一帧：
ffmpeg -ss 00:00:05 -i input.mp4 -vframes 1 -q:v 2 output.jpg
-vframes 1：只输出一帧-q:v 2：JPEG 品质（1-31，越小越好，2 接近无损）
调整输出尺寸用 scale 滤镜，保持宽高比避免变形：
ffmpeg -ss 00:00:05 -i input.mp4 -vframes 1 -vf "scale=320:-1" -q:v 2 output.jpg
-1 表示按原始宽高比自动计算高度。输出 PNG 无损格式则去掉 -q:v，改输出文件名为 .png。
thumbnail 过滤器：智能选帧
固定时间截帧可能正好落在转场或模糊帧上。thumbnail 过滤器从连续帧中选取信息量最大、最具代表性的一帧：
ffmpeg -i input.mp4 -vf "thumbnail=30" -vframes 1 output.jpg
thumbnail=30 表示每 30 帧为一组，从中选出与前后帧差异最大的一帧。帧数越大计算越多，但选出的帧更有代表性。
相比 -ss 直接截帧，thumbnail 的代价是需要解码更多帧，速度慢数倍，适合对缩略图质量要求高的场景（如视频封面）。
结合 thumbnail 和时间区间可以精准控制选帧范围：
# 在视频第 5-10 秒之间智能选帧 ffmpeg -ss 00:00:05 -i input.mp4 -to 00:00:10 -vf "thumbnail=30" -vframes 1 output.jpg
批量生成等间距缩略图
视频网站常见的进度条预览、故事板等需要等间距提取多帧：
# 每隔 60 秒提取一帧 ffmpeg -i input.mp4 -vf "fps=1/60" -q:v 2 output_%04d.jpg
fps=1/60：每 60 秒取一帧output_%04d.jpg：输出文件名按序号命名（output_0001.jpg, output_0002.jpg ...）
按百分比提取（如每 10% 取一帧）：
# 先获取视频时长，再计算间隔 duration=$(ffprobe -v error -show_entries format=duration -of csv=p=0 input.mp4) interval=$(echo "$duration / 10" | bc -l) ffmpeg -i input.mp4 -vf "fps=1/$interval" -vframes 9 -q:v 2 output_%04d.jpg
网格缩略图（Sprite Sheet）
将多张缩略图拼成一张网格图，是视频播放器预览条的标准做法：
ffmpeg -i input.mp4 -vf "select=not(mod(n\,100)),scale=160:90,tile=5x5" -vsync vfr output_grid.jpg
拆解这条命令：
select=not(mod(n,100))：每 100 帧选一帧scale=160:90：每帧缩放到 160x90tile=5x5：拼成 5 行 5 列的网格-vsync vfr：可变帧率，防止帧率同步问题
注意 select 滤镜中的逗号需要转义为 \,，否则 FFmpeg 会将逗号误认为滤镜分隔符。
生成带时间戳标注的网格缩略图：
ffmpeg -i input.mp4 -vf "select=not(mod(n\,100)),scale=160:90,tile=5x5,drawtext=fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:text='%{pts\:hms}':fontcolor=white:fontsize=12:borderw=1:bordercolor=black:x=5:y=5" -vsync vfr output_grid_timestamped.jpg
drawtext 滤镜在每帧左上角叠加时间戳，方便定位视频段落。
带时间戳水印的缩略图
在单张或多张缩略图上叠加时间戳信息，便于识别截取位置：
ffmpeg -ss 00:00:05 -i input.mp4 -vframes 1 -vf "drawtext=fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf:text='%{pts\:hms}':fontcolor=white:fontsize=16:borderw=1:bordercolor=black:x=10:y=10" output_timestamped.jpg
macOS 上字体路径不同：
# macOS 字体路径示例 drawtext=fontfile=/Library/Fonts/Arial.ttf:text='%{pts\:hms}'
生成 GIF 动图缩略图
动态缩略图比静态图更能展示视频内容，常用于社交媒体和内容平台：
# 生成 3 秒、15fps、宽度 320px 的 GIF ffmpeg -ss 00:00:05 -i input.mp4 -t 3 -vf "fps=15,scale=320:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" output.gif
split+palettegen+paletteuse：两遍调色板优化，显著提升 GIF 画质lanczos：高质量缩放算法
控制 GIF 文件大小，降低分辨率和帧率：
# 降低帧率到 10fps，宽度 240px ffmpeg -ss 00:00:05 -i input.mp4 -t 2 -vf "fps=10,scale=240:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" output_small.gif
代码集成
Python 调用
import subprocess def generate_thumbnail(video_path, output_path, timestamp="00:00:05", width=320): cmd = [ "ffmpeg", "-ss", timestamp, "-i", video_path, "-vframes", "1", "-vf", f"scale={width}:-1", "-q:v", "2", "-y", output_path ] result = subprocess.run(cmd, capture_output=True, text=True) if result.returncode != 0: raise RuntimeError(f"FFmpeg error: {result.stderr}") return output_path def generate_thumbnail_smart(video_path, output_path, start="00:00:05", end="00:00:10"): """使用 thumbnail 过滤器智能选帧""" cmd = [ "ffmpeg", "-ss", start, "-i", video_path, "-to", end, "-vf", "thumbnail=30", "-vframes", "1", "-q:v", "2", "-y", output_path ] result = subprocess.run(cmd, capture_output=True, text=True) if result.returncode != 0: raise RuntimeError(f"FFmpeg error: {result.stderr}") return output_path
Node.js 调用
const { execFile } = require("child_process"); function generateThumbnail(videoPath, outputPath, timestamp = "00:00:05") { return new Promise((resolve, reject) => { execFile("ffmpeg", [ "-ss", timestamp, "-i", videoPath, "-vframes", "1", "-q:v", "2", "-y", outputPath ], (error, stdout, stderr) => { if (error) reject(error); else resolve(outputPath); }); }); } async function generateGridThumbnail(videoPath, outputPath, cols = 5, rows = 5) { return new Promise((resolve, reject) => { execFile("ffmpeg", [ "-i", videoPath, "-vf", `select=not(mod(n\\,100)),scale=160:90,tile=${cols}x${rows}`, "-vsync", "vfr", "-y", outputPath ], (error, stdout, stderr) => { if (error) reject(error); else resolve(outputPath); }); }); }
硬件加速截帧
处理 HEVC/AV1 等高压缩率编码的视频时，CPU 解码可能成为瓶颈。启用 GPU 加速：
# NVIDIA CUDA ffmpeg -hwaccel cuda -ss 00:00:05 -i input.mp4 -vframes 1 output.jpg # Intel QSV ffmpeg -hwaccel qsv -ss 00:00:05 -i input.mp4 -vframes 1 output.jpg # Apple VideoToolbox ffmpeg -hwaccel videotoolbox -ss 00:00:05 -i input.mp4 -vframes 1 output.jpg
硬件加速的可用性取决于编译选项，用 ffmpeg -hwaccels 查看当前版本支持哪些加速方式。
硬件加速与两段式 seek 结合，进一步提速：
ffmpeg -hwaccel cuda -ss 00:00:03 -i input.mp4 -ss 2 -vframes 1 output.jpg
常见问题
截出黑帧或模糊帧怎么办？
视频开头可能是黑屏或转场，固定时间截帧容易踩坑。改用 thumbnail 过滤器自动选择信息量最大的帧，或在 seek 时避开开头前几秒。也可以用 blackframe 过滤器检测并跳过黑帧：
ffmpeg -i input.mp4 -vf "blackframe=0.5:64" -f null - 2>&1 | grep "blackframe"
为什么 -ss 在 -i 前截出来的时间不对？
-ss 放在 -i 前是 input-level seek，直接跳到最近的关键帧，不会逐帧解码。如果关键帧间隔较大（如 10 秒），偏移可能达到数秒。需要精确时改用 output-level seek（-ss 在 -i 后）或两段式方案。
批量处理几百个视频如何提速？
用 GNU Parallel 或 xargs 并行调用 FFmpeg，同时配合 -ss 前置的快速 seek：
find . -name "*.mp4" | xargs -P 8 -I {} ffmpeg -ss 00:00:05 -i {} -vframes 1 -q:v 2 {}.jpg
-P 8 表示 8 个并行进程，根据 CPU 核心数调整。
如何输出 WebP 格式的缩略图？
WebP 比 JPEG 体积更小、质量相当，适合 Web 场景：
ffmpeg -ss 00:00:05 -i input.mp4 -vframes 1 -compression_level 6 -quality 85 output.webp
-compression_level 控制编码耗时（0-6，6 最慢但压缩率最高），-quality 控制画质（0-100）。