video-resolution-upscale

사용 방법

설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.

npx skills add https://github.com/meitu/meitu-skills --skill video-resolution-upscale

시작 전 확인

설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.

원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Video Resolution Upscale

Overview

调用 meitu video-resolution-upscale 做专项视频分辨率超分（720P/1080P/2K/4K）。仅做像素级分辨率重建，不修复画质、不去模糊、不降噪、不补帧、不调色、不调亮度，保持原画面风格不变。

不处理：综合画质修复（无任何分辨率信号）、补帧/流畅度、视频去噪、视频夜景增强、图片超分。

API Mapping

DAG 工具	后端 API
video-resolution-upscale	`video_superres_enhance`

Dependencies

meitu-cli: >=2.0.6
凭证：CONFIG AKSK → meitu tools update；EXEC AKSK → 跑命令
环境变量：MEITU_OPENAPI_TOOL_TASK_MODE=command

路径别名：$VISUAL = {OPENCLAW_HOME}/workspace/visual/

Core Workflow

Preflight → Execute → Deliver

Preflight

meitu --version ≥ 2.0.6；meitu auth verify --json
确认已跑过 Config Phase；MEITU_OPENAPI_TOOL_TASK_MODE=command
outputdir 解析：openclaw.yaml → `./output/` | else → `$VISUAL/output/video-resolution-upscale/`；`mkdir -p {outputdir}`

Execute

触发信号/路由（两层判定）

第一层（进入流程）：含"分辨率 / 超分 / 放大 / 升清 / 720P / 1080P / 2K / 4K"任一信号
第二层（直接调用 vs 追问）：已明确目标值 → 直接调用；未明确（"分辨率太低"/"放大点"）→ 追问

决策顺序：

含分辨率相关诉求？否 → 本工具不处理（能力范围外，引导 video-quality-enhance）
目标分辨率明确性：无具体值 → 提示"请指定目标分辨率：720P / 1080P / 2K / 4K"
video_url 缺失 → 追问
目标分辨率必须高于原视频
唯一路由 → video_superres_enhance

示例：

"把视频提升到 4K" → target_resolution=4K
"模糊老视频修复成 4K" → target_resolution=4K（含分辨率诉求，本工具承接）
"帮我修复一下这个视频" → 本工具不处理（无分辨率诉求）

参数定义

参数	类型	必填	范围	默认值	说明
`video_url`	STRING	是	--	--	视频地址；缺失 → "请提供视频链接"
`target_resolution`	STRING	是	720p / 1080p / 2K / 4K	--	必须由用户显式给出，无默认值；高于原视频分辨率

无 `target_resolution` 时不可调用本工具。

工具调用

bash

meitu video-resolution-upscale \
  --skill_name skill_video-resolution-upscale \
  --video_url {video_url} \
  --target_resolution {720p|1080p|2K|4K} \
  --json --download-dir {output_dir}

错误降级

场景	处理
`video_url` 缺失	提示"请提供视频链接"
`video_url` 不可访问	不重试，提示"请提供有效视频链接"
`target_resolution` 缺失但有分辨率诉求	提示"请指定目标分辨率：720P/1080P/2K/4K"
`target_resolution` 缺失且无任何分辨率诉求	本工具不处理，返回能力范围外
目标分辨率 ≤ 原视频	不调用，提示"目标分辨率需高于原视频"
`target_resolution` 非法值	提示"仅支持 720P/1080P/2K/4K"
调用失败	重试 1 次，仍失败返回错误
超时	降低目标分辨率重试 1 次，仍超时返回错误
内容合规拦截	直接返回合规提示，不重试
输入为图片	拒绝，本工具仅处理视频

Deliver

解析 --json → downloaded_files[0].saved_path 或 media_urls[0]。超高分辨率（4K）处理时间较长。

mv {file} {output_dir}/{YYYY-MM-DD}_{name}_{target_resolution}.mp4

Output

格式：MP4（目标 720p/1080p/2K/4K）
命名：{YYYY-MM-DD}_{descriptive-name}_{target_resolution}.mp4
位置：项目 → ./output/；一次性 → $VISUAL/output/video-resolution-upscale/

基线 Task ID

t_mt1a3i5n7b6aae04c9-f602-468d-920f-3cc73501c44c