SuperAPI AI 工具集

byted-byteplus-vod-precision-erasure

设计与创作

查看项目

更新于 10-15 17:30

技能介绍

用途:把视频/音频上传到 BytePlus VOD 空间(本地文件或公网 URL),返回 vid:// 引用;对已在 VOD 的媒体提交精准擦除任务(StartExecution → Operation.Task.Type: Erase),仅使用自动 OCR。

主要能力:上传本地文件走 ApplyUploadInfo → TOS PUT(小于 20 MiB 直传,否则分片)→ CommitUploadInfo 得到 Vid;URL 上传走 UploadMediaByUrl 后轮询 QueryUploadTaskInfo。擦除默认仅字幕(Auto.Type: Subtitle,SubtitleFilter: {}),可用 text: true 或 all_text: true 扩展到全部屏幕文字(Auto.Type: Text)。时间线默认整段视频,可选 clip_filter(mode 为 skip 或 selected,此时 clips 必填且非空)。NewVid 恒为 true,不可配置;with_erase_info 默认 true,为 false 时 stdout 的 EraseMeta 为 {}。不支持 Manual 模式、自定义 ratio Locations、调整 SubtitleFilter、VideoOption.EncodeMode 及覆盖 NewVid。

使用方式:需设置 BYTEPLUS_ACCESSKEY、BYTEPLUS_SECRETKEY、VOD_SPACE_NAME(可在工作目录放 .env 自动加载)。在技能根目录运行:uv run python scripts/upload.py "/path/to/video.mp4" [space_name];URL 上传:uv run python scripts/upload.py "https://example.com/video.mp4" [space_name];擦除:uv run python scripts/precise_erase.py '{"type":"Vid","video":"v0310abc"}';超时续跑:uv run python scripts/poll_execution.py '<RunId>' [space_name]。路径与 URL 需带扩展名。

适用场景:需要上传媒体到 VOD 并获取 Vid/播放地址,或对 VOD 内媒体做字幕/屏幕文字擦除。

限制:若遇 HTTP 403 或 Permission denied,需按 BytePlus VOD 说明处理 allowlist/工单;轮询超时(默认 360 次 × 5 秒)会返回 resume_hint;失败统一输出 {"error": "..."}。