mcpField
V
video-framerate-enhance

video-framerate-enhance

github.com/meituCreative & media36110 installsUpdated 9w ago
Repository

About video-framerate-enhance

A skill that uses meitu-cli to increase a video's frame rate for creators seeking smoother motion. It changes frame rate without changing duration and does not handle general image repair or speed changes.

Key features

  1. 01Raise frame rate to 24, 30, or 60 fps
  2. 02Keep video duration unchanged
  3. 03Accept a video URL and deliver MP4

Use cases

  1. 01Smooth playback of low-frame-rate older videos
  2. 02Add frames to game or sports videos
  3. 03Smooth slow-motion footage

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/meitu/meitu-skills --skill video-framerate-enhance

After installing, type/video-framerate-enhancein Claude Code to confirm it loaded.

Details

From the project README

Video Framerate Enhance

Overview

视频帧率提升 / 插帧（如 24fps → 60fps），让低帧率视频运动更流畅。覆盖老视频流畅化、游戏/运动视频补帧、慢动作效果平滑处理。视频时长不变，仅帧率提升。

不处理：综合画质修复、超分辨率、视频去噪、变速 / 改时长、剪辑 / 拼接。

API Mapping

场景API name
视频补帧 / 帧率提升video_framerate_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
  1. meitu --version 与 meitu auth verify --json
  2. 检测 MEITU_OPENAPI_TOOL_TASK_MODE=command
  3. output_dir：项目 → ./output/；一次性 → $VISUAL/output/video-framerate-enhance/；mkdir -p
Execute

触发信号与路由

用户原话路由
补帧 / 插帧 / 提帧率 / 60 帧 / 120 帧 / 流畅video_framerate_enhance
"视频更流畅一点"（意图模糊）轻确认"是要补帧让运动更流畅，还是做整体画质修复？"

单 API 工具：参数齐全即调用，失败重试 1 次后返回错误。

参数定义

参数类型必填范围默认说明
video_urlSTRING是——视频地址
frame_rateNUMBER否24 / 30 / 6060目标帧率（fps）

说明：

  • 目标帧率 ≤ 原帧率 → 不调用，直接返回原视频并告知
  • 视频时长不变，仅帧率提升

工具调用

meitu video-framerate-enhance --video_url {url} [--frame_rate 60] --json --download-dir {output_dir}  --skill_name skill_video-framerate-enhance

错误降级

场景处理
video_url 缺失提示"请提供需要补帧的视频链接"
video_url 不可访问不重试，提示"请提供有效视频链接"
目标帧率 ≤ 原帧率不调用，直接返回原视频并告知
frame_rate 非法值（如 50/90）钳位至最近合法值（24/30/60）
用户说"更流畅"未指定帧率默认 frame_rate=60
API 调用失败 / 超时重试 1 次，仍失败返回错误
内容合规拦截直接返回合规提示，不重试
用户说"变速 / 慢放"告知本工具不支持变速，仅提升帧率
输入为图片拒绝，仅支持视频
Deliver

mv {file} {output_dir}/{date}_{name}_framerate.mp4

Output

  • 格式：MP4
  • 命名：{YYYY-MM-DD}_{descriptive-name}_framerate.mp4
  • 位置：项目 → ./output/；一次性 → $VISUAL/output/video-framerate-enhance/

基线 Task ID

t_mt1a3i5n7b1f3f37c1-30d2-4aa7-8671-96215839c41f

Comments

Markdown supported