SuperAPI AI 工具集

extract-frames

设计与创作

查看项目

更新于 10-15 22:11

技能介绍

用途:从视频中按镜头自动检测并提取每个镜头的首帧和/或末帧,适合需要镜头切分、关键帧采样或素材整理的场景。

主要能力:使用 ffmpeg 的 scene 检测逐帧打分,通过 awk 分析分数分布、过滤片头伪影、做基于 run 的去重,识别真实剪切点;支持提取首帧(默认)、末帧(--last)、两者(--first --last 或 --all)、指定镜头(--shots N,N,N)以及自定义阈值(--threshold X)。输出目录为视频旁的 {video_basename}_frames/,首帧命名如 shot_01_0.00s.png,末帧如 shot_01_last_1.60s.png,并保留 scores.txt 以便换阈值重跑。

使用方式:需提供视频路径;先经 ffprobe 获取 fps 与时长,再用 ffmpeg 导出逐帧场景分数,随后解析、确认阈值并抽帧。若输出目录已存在 scores.txt,则跳过打分阶段直接分析,便于快速迭代阈值。

限制与边界:依赖 ffmpeg/ffprobe 环境;单镜头视频会报告无剪切点;片头淡入可能产生伪高分,需过滤;末帧在视频结尾附近可能产生空文件,需回退一帧重试;脚本使用管道循环以兼容 zsh 与 bash。具体收费、平台支持等信息暂未提供。