如何快速抓取视频每10%位置的帧以生成缩略图？

你的问题核心在于按帧索引读取会强制解码所有前置帧——因为视频采用帧间压缩（如H.264），非关键帧依赖前面的帧数据，直接读取指定索引的帧需要从开头解码到目标帧，长视频自然慢。要解决这个问题，必须跳过不必要的解码，直接定位到目标时间点的关键帧。

下面是两种高效的实现方案：

方案一：用FFmpeg命令行（推荐，速度最快） #

FFmpeg支持快速seek到关键帧，无需解码中间所有帧。通过-ss参数（放在输入文件前）直接定位到目标时间点的最近关键帧，然后提取单帧。

Python代码实现 #

import os
import subprocess
import logging
import iio

logger = logging.getLogger(__name__)

def extract_video_thumbnails(video_obj):
    video_path = video_obj.file.path
    metadata = iio.immeta(video_path, exclude_applied=False)
    total_duration = metadata['duration']
    
    for i in range(10):
        # 计算当前10%区间的时间戳
        timestamp = total_duration * (i * 0.1)
        output_path = video_obj.get_thumbnail_path(index=i)
        
        # 创建输出目录（如果不存在）
        os.makedirs(os.path.dirname(output_path), exist_ok=True)
        
        # 构造FFmpeg命令：快速seek到关键帧并提取单帧
        cmd = [
            'ffmpeg',
            '-ss', str(timestamp),  # 先seek到目标时间，优先定位关键帧
            '-i', video_path,
            '-vframes', '1',       # 仅提取1帧
            '-q:v', '2',           # 图片质量（2为高质量，数值越小质量越高）
            '-y',                  # 覆盖已存在文件
            output_path
        ]
        
        # 执行命令，捕获输出避免冗余日志
        try:
            subprocess.run(cmd, check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
            logger.info(f'Written video thumbnail: {output_path}')
        except subprocess.CalledProcessError as e:
            logger.error(f'Failed to extract thumbnail {i}: {e.stderr.decode()}')

关键说明 #

• -ss放在-i前面是核心：FFmpeg会直接利用视频的索引跳转到最近的关键帧，跳过所有中间帧的解码，速度提升几个数量级。
• 如果你不需要严格精确到10%的帧，只需要该位置附近的关键帧，这个方案完全满足需求。

方案二：用OpenCV Python库（纯Python实现） #

如果不想依赖FFmpeg命令行，可以用OpenCV的视频捕获接口，通过设置时间戳位置实现快速跳转。

Python代码实现 #

import cv2
import os
import logging
import iio

logger = logging.getLogger(__name__)

def extract_video_thumbnails(video_obj):
    video_path = video_obj.file.path
    cap = cv2.VideoCapture(video_path)
    
    # 获取视频总时长（通过总帧数和帧率计算）
    total_frames = cap.get(cv2.CAP_PROP_FRAME_COUNT)
    fps = cap.get(cv2.CAP_PROP_FPS)
    total_duration = total_frames / fps
    
    for i in range(10):
        timestamp = total_duration * (i * 0.1)
        output_path = video_obj.get_thumbnail_path(index=i)
        os.makedirs(os.path.dirname(output_path), exist_ok=True)
        
        # 设置视频位置为目标时间戳（毫秒）
        cap.set(cv2.CAP_PROP_POS_MSEC, timestamp * 1000)
        ret, frame = cap.read()
        
        if ret:
            cv2.imwrite(output_path, frame)
            logger.info(f'Written video thumbnail: {output_path}')
        else:
            logger.warning(f'Failed to read frame at {timestamp}s')
    
    cap.release()

注意事项 #

• OpenCV的CAP_PROP_POS_MSEC跳转在部分视频格式下可能无法完全跳转到关键帧，但依然比逐帧读取快很多。
• 如果你的OpenCV是用FFmpeg后端编译的，实际效果和FFmpeg命令行接近。

为什么你的原代码慢？ #

原代码中vObj.read(index=x)需要解码从第一帧到第x帧的所有非关键帧——因为这些帧依赖前面的帧数据才能解码，长视频会产生大量不必要的计算，导致速度极慢。而上述方案都是直接定位关键帧，跳过了中间帧的解码流程，自然效率更高。

内容的提问来源于stack exchange，提问作者JasonTS