mcpField
V
video-enhancement

video-enhancement

github.com/verging-ai创意与媒体046 次安装20 周前更新
代码仓库

关于 video-enhancement

video-enhancement 是调用 verging.ai 的视频 AI 增强技能，可处理本地文件或 YouTube、Bilibili 视频，并支持裁剪片段与高清放大。

主要功能

  1. 01通过 verging.ai 增强视频画质
  2. 02支持本地文件和视频链接
  3. 03设置起止时间并裁剪至 30 秒内
  4. 04可选高清放大及自动下载

适用场景

  1. 01提升短视频画质
  2. 02增强 YouTube 或 Bilibili 视频片段

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/verging-ai/agent-skills --skill video-enhancement

安装后在 Claude Code 中输入/video-enhancement确认已加载。

附带文件README.md

详细介绍

video-enhancement - AI 视频增强

通过 verging.ai 使用 AI 提升视频分辨率和画质。

命令格式

/video-enhancement --video <video file or URL> [options]

选项

选项简写描述默认值
--video-v视频文件路径或 URL（YouTube/Bilibili）必填
--start-s开始时间（秒）0
--end-e结束时间（秒）视频结束（最长 30 秒）
--hdHD 升频（5 积分/秒）false（3 积分/秒）
--api-key-kAPI Key$VERGING_API_KEY
--output-o结果保存路径当前目录
--download-d自动下载结果false

身份验证

建议使用： Authorization: ApiKey <your_key>

# ✅ Recommended (canonical form)
curl -H "Authorization: ApiKey vrg_sk_your_key_here" https://verging.ai/api/v1/auth/me

# ✅ Also works (Bearer with API key is supported)
curl -H "Authorization: Bearer vrg_sk_your_key_here" https://verging.ai/api/v1/auth/me

获取 API key：https://verging.ai → 登录 → 头像 → API Keys

API 参考（精确格式）

1. 查询积分
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
  https://verging.ai/api/v1/auth/me

响应：{"email":"...","name":"...","credits":100}

2. 获取上传 URL（表单数据，非 JSON）
# ⚠️ MUST use -F (multipart form-data)
curl -X POST https://verging.ai/api/v1/upload-video \
  -H "Authorization: ApiKey $VERGING_API_KEY" \
  -F "video_file_name=video.mp4" \
  -F "job_type=video-enhance"

响应：

{
  "code": 100000,
  "result": {
    "url": "https://...presigned-url...",
    "public_url": "https://img.panpan8.com/video-enhance/..."
  }
}
3. 将视频上传到 R2
curl -X PUT -T /tmp/verging-video-enhancement/trimmed.mp4 \
  -H "Content-Type: video/mp4" \
  "<presigned_url_from_step_2>"
4. 创建增强任务（表单数据）
# ⚠️ Uses -F (form-data), NOT JSON
curl -X POST https://verging.ai/api/v1/video_enhance/create-job \
  -H "Authorization: ApiKey $VERGING_API_KEY" \
  -F "target_video_url=<public_url_from_step_2>" \
  -F "file_name=video.mp4" \
  -F "user_video_duration=30" \
  -F "job_type=video-enhance" \
  -F "is_hd=false"

响应：{"code":10000,"result":{"job_id":"123"},"message":{"en":"Request Success","zh":"提交任务成功"}}

5. 轮询任务状态
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
  "https://verging.ai/api/v1/jobs/list-jobs?job_ids=<job_id>"

响应：[{"id":123,"job_type":"video-enhance","status":"COMPLETED","progress":100,"result_url":"https://...","created_at":"...","updated_at":"..."}]

状态值：PENDING → PROCESSING → COMPLETED（或 FAILED）

执行流程（请严格遵循）

  1. 解析参数 → 提取视频路径/URL 和选项
  2. 下载远程视频（如果是 URL）：yt-dlp "URL" -o /tmp/verging-video-enhancement/input.mp4
  3. 获取时长 → ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 video.mp4
  4. 按需剪辑（使用 --start/--end 或时长超过 30 秒）： 
    ffmpeg -i input.mp4 -ss <start> -to <end> -c:v libx264 -c:a aac /tmp/verging-video-enhancement/trimmed.mp4
  5. 查询积分 → GET /api/v1/auth/me（所需积分为时长 × 3（普通模式）或 ×5（HD））
  6. 上传视频 → POST /upload-video（表单数据）→ PUT 到预签名 URL
  7. 创建任务 → POST /video_enhance/create-job（表单数据）
  8. 轮询状态 → 每 5 秒 GET /jobs/list-jobs?job_ids=X，直到状态为 COMPLETED
  9. 返回/下载结果 → 显示 result_url，可选择使用 curl 下载

重要说明

  • 使用 Authorization: ApiKey <key>（建议） — Bearer <key> 也可用
  • /upload-video 使用表单数据（-F） — 非 JSON
  • /video_enhance/create-job 使用表单数据（-F） — 非 JSON，无需上传文件
  • 视频最长时长：30 秒 — 更长的视频需先剪辑
  • 临时目录： /tmp/verging-video-enhancement/
  • 如果 yt-dlp 不可用，请让用户手动下载视频

积分消耗

模式费用
普通3 积分/秒
HD5 积分/秒

隐私与安全

  • 通过环境变量设置密钥：export VERGING_API_KEY="your_key"
  • 切勿在公开仓库中泄露 API key
  • 仅处理你有权使用的媒体
  • 使用后清理临时文件

评论

支持 Markdown