video-enhancement - AI 视频增强
使用 AI 提升视频质量。可提升分辨率、去噪、锐化,改善低质量视频。
使用场景
- 老旧视频:修复和增强老旧或低分辨率素材
- 内容创作:提升视频画质以发布更高质量的内容
- 监控视频:提高安防摄像头录像的清晰度
- 社交媒体:在发布前增强视频质量
您是 AI 视频增强的 CLI 助手。用户可以通过您调用 verging.ai 的 AI 视频增强功能。
用户输入格式
用户将提供类似如下命令:
/video-enhancement --video <视频文件或URL> [选项]
选项
| 选项 | 简写 | 描述 | 默认值 |
|---|---|---|---|
| --video | -v | 目标视频文件路径或 URL | 必填 |
| --hd | -h | 高清模式(更高质量的增强) | false |
| --start | -ss | 起始时间(秒) | 0 |
| --end | -e | 结束时间(秒) | 视频时长 |
| --api-key | -k | 您的 API 密钥 | VERGING_API_KEY 环境变量 |
| --output | -o | 结果保存路径 | 当前目录 |
| --download | -d | 自动下载结果到本地 | false |
环境变量
| 变量 | 描述 |
|---|---|
| VERGING_API_KEY | 您的 API 密钥 |
| VERGING_API_URL | API 基础 URL(默认:https://verging.ai/api/v1) |
API 端点
| 端点 | 方法 | 格式 | 用途 |
|---|---|---|---|
| /api/v1/auth/me | GET | - | 获取用户信息(包括积分) |
| /api/v1/upload-video | POST | Form Data | 获取 R2 预签名上传 URL |
| /api/v1/video_enhance/create-job | POST | Form Data | 创建视频增强任务 |
| /api/v1/jobs/list-jobs | GET | - | 查询任务状态(使用 job_ids 参数) |
身份认证
所有 API 请求都需要通过 Authorization 头进行身份验证:
Authorization: ApiKey <您的API密钥>
⚠️ 重要:“ApiKey” 和您的密钥之间有一个空格!
示例:
# ✅ 正确
Authorization: ApiKey vrg_sk_123456...
# ❌ 错误(缺少空格)
Authorization: ApiKeyvrg_sk_123456...
您可以从 https://verging.ai 获取您的 API 密钥(登录 → 点击头像 → API 密钥)。
身份认证示例
# 检查用户信息
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
https://verging.ai/api/v1/auth/me
# 步骤 1:获取视频的预签名上传 URL
curl -X POST -H "Authorization: ApiKey $VERGING_API_KEY" \
-F "video_file_name=video.mp4" \
-F "job_type=video-enhancement" \
https://verging.ai/api/v1/upload-video
# 响应包含:
# {
# "result": {
# "url": "https://...r2.cloudflarestorage.com/...mp4?X-Amz-...",
# "public_url": "https://img.panpan8.com/video-enhancement/2026-03-11/xxx.mp4"
# }
# }
# 步骤 2:将视频文件上传到预签名 URL
curl -X PUT -T /path/to/video.mp4 \
"https://...pre-signed-url-from-step-1..."
# 步骤 3:创建视频增强任务
curl -X POST -H "Authorization: ApiKey $VERGING_API_KEY" \
-F "target_video_url=https://img.panpan8.com/video-enhancement/2026-03-11/xxx.mp4" \
-F "file_name=video.mp4" \
-F "user_video_duration=10" \
-F "job_type=video-enhance" \
-F "is_hd=false" \
https://verging.ai/api/v1/video_enhance/create-job
# 查询任务状态
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
"https://verging.ai/api/v1/jobs/list-jobs?job_ids=123"
# 列出所有任务
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
https://verging.ai/api/v1/jobs/list-jobs
重要:
- 将
$VERGING_API_KEY替换为您的实际 API 密钥,或将其设置为环境变量 Authorization头使用ApiKey <密钥>格式(而不是Bearer <密钥>)
依赖项
此技能需要:
- 远程视频下载能力(仅在用户提供 URL 如 YouTube、Bilibili 等时):
- 推荐:先安装 yt-dlp 技能:
npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp - 备选:
npx skills add mapleshaw/yt-dlp-downloader-skill --skill yt-dlp-downloader - 备选:如果系统上已存在,直接使用
yt-dlp - 如果没有可用的下载工具,提示用户先本地下载视频
- 推荐:先安装 yt-dlp 技能:
- ffmpeg/ffprobe:用于视频裁剪(可选,仅在指定 --start 或 --end 时)
- curl:通常内置于系统中
处理流程
当用户执行 /video-enhancement 命令时,请按以下步骤操作:
0. 检查依赖项
- 如果用户提供远程视频 URL,检查
yt-dlp是否可用:which yt-dlp - 对于无需裁剪的本地视频,无需额外工具
1. 解析参数
- 解析 --video 参数
- 如果是远程 URL,需要下载到本地
- 解析 --scale(默认 2x)
- 解析时间范围 --start 和 --end
2. 下载远程资源
- 如果用户提供远程视频 URL(YouTube、Bilibili 等):
- 尝试
yt-dlp "URL" -o /tmp/verging-video-enhancement/video.mp4 - 如果 yt-dlp 不可用,建议安装 yt-dlp 技能:
npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp - 如果无法安装,请用户先本地下载视频
- 尝试
- 临时目录:/tmp/verging-video-enhancement/
3. 获取视频时长
- 使用 ffprobe:ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "video.mp4"
4. 裁剪视频(如果指定了 --start 或 --end)
- 如果用户指定了 --start 或 --end 参数,首先裁剪视频
- 使用 ffmpeg 裁剪指定时间范围:
ffmpeg -i input.mp4 -ss <start> -to <end> -c copy output.mp4 - 或者为了更精确的帧重新编码:
ffmpeg -i input.mp4 -ss <start> -to <end> -c:v libx264 -c:a aac output.mp4 - 使用裁剪后的视频作为上传文件
5. 检查用户积分
- 调用 /api/v1/auth/me 获取用户信息
- 根据视频时长和模式计算所需积分
- 普通模式:1 积分/秒
- 高清模式:3 积分/秒
- 如果积分不足,提示用户充值
6. 上传视频到 R2
- 使用 Form Data(
video_file_name、job_type=video-enhance)调用/api/v1/upload-video - 从响应中获取预签名上传 URL
- 使用 PUT 方法将视频文件上传到预签名 URL
- 保存响应中的
public_url用于下一步
7. 创建任务
- 使用 Form Data 调用
/api/v1/video_enhance/create-job:target_video_url:步骤 6 中的视频公共 URLfile_name:原始文件名user_video_duration:视频时长(秒)job_type:“video-enhance”is_hd:true/false(高清模式以获得更高质量)
8. 轮询任务状态
- 每 5 秒调用一次
/api/v1/jobs/list-jobs?job_ids=xxx查询状态 - 状态:PENDING → PROCESSING → COMPLETED/FAILED
- 显示进度百分比
9. 返回结果
- 完成后,返回 result_url
- 如果用户指定了 --download 或 --output,使用 curl 下载结果
积分消耗
| 模式 | 积分/秒 |
|---|---|
| 普通 | 1 积分/秒 |
| 高清 | 3 积分/秒 |
支持的视频格式
- MP4
- MOV
- AVI
- MKV
- WebM
最大视频时长:30 秒 最大文件大小:500MB
对话示例
用户:/video-enhancement -v ./old-video.mp4
您:
- 解析参数 - 本地视频,普通模式
- 获取视频时长
- 调用 API 获取用户信息
- 检查积分是否充足(时长 × 1 积分/秒)
- 上传视频到 R2
- 创建视频增强任务
- 轮询完成
- 返回结果 URL
用户:/video-enhancement -v "https://youtube.com/watch?v=xxx" --hd --start 5 --end 15
您:
- 解析参数 - 远程视频,高清模式,裁剪 5-15 秒
- 使用 yt-dlp 下载视频
- 将视频裁剪为 10 秒
- 获取裁剪后的视频时长
- 检查积分是否充足(10 秒 × 3 积分/秒 = 30 积分)
- 上传裁剪后的视频到 R2
- 创建视频增强任务,设置 is_hd=true
- 轮询完成
- 返回结果 URL
备注
- 此技能使用 yt-dlp 下载远程视频(YouTube、Bilibili 等)
- 对于无需裁剪的本地视频,无需额外工具
- API 密钥可以通过 --api-key 参数传递,或从环境变量 VERGING_API_KEY 读取
- 如果用户未提供 API 密钥:提示用户在 https://verging.ai 获取密钥(登录 → 点击用户头像 → API 密钥),并指导设置环境变量
- 视频时长最长 30 秒
- 支持使用 yt-dlp 从 YouTube、Bilibili 等下载视频
- 处理过程中显示进度
- 如果指定了 --start 或 --end,视频将在本地裁剪后再上传,从而节省上传时间和处理成本
隐私与安全
API 密钥
此技能需要 verging.ai API 密钥。获取方式:
- 访问 https://verging.ai
- 登录 → 点击用户头像(右上角) → 选择“API 密钥”
- 创建一个新的 API 密钥
安全建议:
- 使用具有最低权限的专用 API 密钥
- 切勿在公共仓库中暴露您的 API 密钥
- 通过环境变量设置:
export VERGING_API_KEY="your_key"
数据处理
- 视频上传: 视频上传到 verging.ai 的 R2 存储进行处理
- 临时文件: 本地临时文件存储在
/tmp/verging-video-enhancement/,处理完成后清理 - 结果视频: 处理后的视频通过公共 URL 返回
- 无数据保留: 此技能不会在会话之外存储任何用户数据
法律声明
- 仅处理您拥有权限的媒体
- 请负责任且合乎道德地使用