video-enhancement 是一个通过 verging.ai 提供的 AI 视频增强技能，主要用于提升视频画质，包括分辨率放大、降噪和锐化。它支持处理本地视频文件，也支持 YouTube 和 Bilibili 等平台的视频 URL，能够进行 HD/4K 级别的画质增强，并在处理过程中提供实时进度反馈。
主要能力
该技能的核心能力是对视频进行 AI 增强处理，具体包括：
- 视频分辨率放大（Upscale）
- 视频降噪（Denoise）
- 视频锐化（Sharpen）
- 支持 HD 级别增强
- 支持本地文件和 YouTube/Bilibili URL 输入
- 提供实时进度反馈
使用方式
该技能通过命令行调用，命令格式为：
/video-enhancement --video <video file or URL> [options]
可用选项包括：
--video/-v：视频文件路径或 URL（YouTube/Bilibili），必填--start/-s：起始时间（秒），默认 0--end/-e：结束时间（秒），默认视频结尾，最大 30 秒--hd：启用 HD 放大（5 积分/秒），默认关闭（3 积分/秒）--api-key/-k：API 密钥，默认读取$VERGING_API_KEY--output/-o：结果保存路径，默认当前目录--download/-d：自动下载结果，默认关闭
认证方式
推荐使用 Authorization: ApiKey <your_key> 头部进行认证，也支持 Bearer <key> 形式。API 密钥可通过 verging.ai 登录后，在头像菜单的 API Keys 页面获取。
执行流程
该技能的执行流程如下：
- 解析参数，提取视频路径/URL 和选项
- 若为远程视频，使用
yt-dlp下载到临时目录 - 使用
ffprobe获取视频时长 - 如需裁剪（指定了 start/end 或时长超过 30 秒），使用
ffmpeg裁剪 - 检查积分余额（GET /api/v1/auth/me），所需积分为时长 × 3（普通）或 × 5（HD）
- 上传视频：POST /upload-video（Form Data）获取预签名 URL，再 PUT 上传
- 创建增强任务：POST /video_enhance/create-job（Form Data）
- 轮询任务状态：GET /jobs/list-jobs?job_ids=X，每 5 秒一次，直到 COMPLETED
- 返回或下载结果，展示 result_url，可选下载
积分消耗
- 普通模式：3 积分/秒
- HD 模式：5 积分/秒
适用场景
该技能适用于需要对视频进行画质提升的场景，例如将低分辨率视频放大到 HD 或 4K、对视频进行降噪和锐化处理、处理来自 YouTube 或 Bilibili 的视频内容等。
限制与注意事项
- 视频最大时长为 30 秒，超出需先裁剪
- 临时目录为
/tmp/verging-video-enhancement/ - 如果
yt-dlp不可用，需要用户手动下载视频 /upload-video和/video_enhance/create-job均使用 Form Data（-F），而非 JSON- 任务状态值包括：PENDING → PROCESSING → COMPLETED（或 FAILED）
- 使用前需设置环境变量
export VERGING_API_KEY="your_key" - 不要在公开仓库中暴露 API 密钥
- 仅处理拥有合法权利的媒体内容
- 临时文件在使用后会被清理
隐私与安全
API 密钥应通过环境变量设置，避免在公开仓库中暴露。仅处理拥有合法权利的媒体内容。临时文件在使用后会被清理。