用途:将视频自动拆解为逐帧分镜,提供每个镜头的关键帧图片和时间信息,无需外部后端服务。
主要能力:通过本机 FFmpeg 预处理视频,输出包含 task_id、duration、resolution、segment_count 及 segments 列表(含 index、start、end、frame_paths)的分镜数据。
使用方式: 方式一,视频 URL 直接处理:python scripts/process_video.py "https://example.com/video.mp4" 方式二,本地文件先上传再处理:先执行 python scripts/video_upload.py "/path/to/video.mp4",再用返回的 video_url 执行 python scripts/process_video.py "<video_url>"。
前置要求:本机安装 FFmpeg,例如 brew install ffmpeg。
环境变量:FFMPEG_BIN(可选,默认 ffmpeg)、FFPROBE_BIN(可选,默认 ffprobe)、VOLCENGINE_ACCESS_KEY 与 VOLCENGINE_SECRET_KEY(上传时需要)、DATABASE_TOS_BUCKET(可选)、DATABASE_TOS_REGION(可选,默认 cn-beijing)。
限制与故障排除:FFmpeg not found 需安装 FFmpeg;上传失败需检查 AK/SK 配置和 TOS 存储桶;视频下载失败需确认 URL 有效且可公开访问。其余细节暂未提供。