用途:把视频或音频上传到 BytePlus VOD 点播空间,并可选进行 AI 综合画质修复(去压缩伪影、降噪、去划痕,改善清晰度与色彩)。
主要能力:本地上传为同步三步流程(ApplyUploadInfo、PUT 到 TOS 直传或分片、CommitUploadInfo),返回 Vid;URL 上传为异步两阶段(UploadMediaByUrl 提交任务后轮询 QueryUploadTaskInfo,最长 30 分钟)。画质修复提交 StartExecution/enhanceVideo 后轮询 GetExecution,返回修复文件。输出 JSON 含 Vid、Source(vid:// 引用)、PlayURL、FileName、SpaceName、SourceUrl、JobId;修复输出含 Status、SpaceName、VideoUrls(FileId、DirectUrl、Source、Url)。
使用方式:需配置环境变量 BYTEPLUS_ACCESSKEY、BYTEPLUS_SECRETKEY、VOD_SPACE_NAME(可用 .env)。在技能根目录运行:本地/URL 上传用 uv run python scripts/upload.py "路径或URL" [空间名];画质修复用 uv run python scripts/quality_enhance.py '{"type":"Vid","video":"...","config":"common","repair_style":1}',可用 @params.json 避免转义问题;超时后用 uv run python scripts/poll_execution.py '<RunId>' [空间名] 续轮询。文件或 URL 必须带扩展名。
参数:config 可选 common、ugc、short_series、aigc、old_film;repair_style 为 1 标准或 2 Pro;res 可选 240p 到 4k,省略则保持源分辨率;bit_depth 仅 Pro 支持 8/10/12/16,16 位要求输入不超过 40 秒且串行处理。提交前必须让用户明确选择 config 与 repair_style,不能静默使用默认值。Pro 若返回 403 或 Permission denied,表示需申请白名单。
限制:轮询超时统一为 360 次×5 秒;12 位与 16 位在普通播放器与 SDR 管线可能渲染不正确,建议专业色彩管理工具;本技能未提供目标码率设置。