SuperAPI AI 工具集

byted-byteplus-vod-frame-extraction

设计与创作

查看项目

更新于 10-15 17:30

技能介绍

用途:把视频/音频上传到 BytePlus VOD 空间(本地文件或公网 URL),返回 Vid 与播放引用;对已在 VOD 的媒体提交 Snapshot 抽帧任务,生成缩略图或帧图片。

主要能力:上传支持本地文件(ApplyUploadInfo → TOS 上传 → CommitUploadInfo)与 URL 上传(UploadMediaByUrl → 轮询 QueryUploadTaskInfo)。抽帧支持指定时间(默认 0ms 首帧)、固定间隔、指定帧、场景变化检测;默认分辨率 720p,可选 240p/360p/480p/720p/1080p,支持 scale_long/scale_short、雪碧图 sprite、output_mode(Files/Index),并可用 snapshot 完整透传或 snapshot_options 深合并高级字段。

使用方式:需设置环境变量 BYTEPLUS_ACCESSKEY、BYTEPLUS_SECRETKEY、VOD_SPACE_NAME(可在工作目录放 .env)。上传:uv run python scripts/upload.py "/path/to/video.mp4" [space_name] 或传入 http(s) URL。抽帧:uv run python scripts/snapshot.py '{"type":"Vid","video":"v0310abc"}',可加 strategy、times、interval_ms、frames、threshold、resolution 等;也支持 @params.json。超时后用 uv run python scripts/poll_execution.py '<RunId>' [space_name] 续查。成功时 stdout 输出 JSON,含 Status、SpaceName、ImageUrls[](含 Url、Source)与原始 Snapshot。

适用场景:为 VOD 媒体生成封面/缩略图、按时间点或间隔批量抽帧、按场景变化取关键帧。

限制:需有效 BytePlus 凭证与 VOD 空间;路径和 URL 必须带扩展名;默认策略为 0ms 首帧,用户未给时间点时不应擅自改为等间隔;轮询默认 360 次×5 秒,超时任务仍在处理;签名 URL 有效期默认 60 分钟。费用、配额与平台细节暂未提供。