mcpField
V
video-content-replace

video-content-replace

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

About video-content-replace

video-content-replace is a skill for editing existing videos by replacing people, scenes, clothing, and other elements through text instructions or a reference image. It preserves the original camera movement and actions, for targeted edits rather than new video generation.

Key features

  1. 01Replace video elements from text instructions
  2. 02Replace elements using a reference image
  3. 03Preserve original camera movement and actions
  4. 04Output MP4 files

Use cases

  1. 01Change people or clothing in a video
  2. 02Replace a video scene using a reference image
  3. 03Edit video elements while retaining original actions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/meitu/meitu-skills --skill video-content-replace

After installing, type/video-content-replacein Claude Code to confirm it loaded.

Details

From the project README

Video Content Replace

Overview

对已有视频做内容元素替换（人物/场景/服装/衣物/穿着），保留原始运镜和动作，覆盖 2 类场景：

  1. 文本指令替换：文本指令驱动视频内容修改，无需额外参考图。
  2. 参考图驱动替换：用户提供参考图 + 视频，按参考图替换视频中对应元素。

不处理：视频生成、去水印/去字幕、整体风格变换、音频修改、视频拼接。

API Mapping

场景API namemodel
文本指令替换video_molasses_editmolasses
参考图驱动替换video_molasses_vidimgs2vidmolasses

model 可选：auto（默认，按是否有参考图自动路由）/ molasses（显式指定）。

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-content-replace/；mkdir -p
Execute

触发信号与路由

核心判断维度：是否提供参考图。

场景判定路由
有参考图 + 替换元素有 image_urlvideo_molasses_vidimgs2vid
无参考图 + 文本指令无 image_urlvideo_molasses_edit（默认）

路由原则：image_url 存在时优先走参考图模式，即使用户说"用文字描述修改"也走 vidimgs2vid。

参数定义

参数类型必填范围默认说明
video_urlSTRING是见下方约束—原视频地址
promptSTRING是——修改描述
image_urlSTRING否——参考图 URL；存在时路由至 vidimgs2vid
modelSTRING否auto/molassesauto模型选择

其余参数（duration/ratio/character_orientation 等）由 combo-tool 内部管理，不对外暴露。

video_url 约束（参考图驱动模式专用）：

  • 格式：.mp4 / .mov；大小：≤ 100MB
  • 边长：340px ~ 3850px；时长：3 ~ 30 秒
  • 画面：漏出清晰的上半身/全身，1 人动作，一镜到底，动作平稳

video_molasses_edit（文本指令模式）对 video_url 限制较宽松，主要是格式和大小。

工具调用

# 文本指令
meitu video-content-replace --video_url {url} --prompt "{修改描述}" --json --download-dir {output_dir} --skill_name skill_video-content-replace

# 参考图驱动
meitu video-content-replace --video_url {url} --prompt "{修改描述}" --image_url {ref} --json --download-dir {output_dir} --skill_name skill_video-content-replace

错误降级

场景处理
video_url 缺失提示"请提供视频链接"，不调用
video_url 不可访问直接返回错误，不重试
prompt 缺失提示"请描述你想修改的内容"
image_url 不可访问降级至 video_molasses_edit（仅用 prompt）
video_url 非 mp4/mov提示格式要求，不调用
video_url >100MB 或边长越界提示具体超限项
video_url 时长 <3s / >30s（vidimgs2vid）提示时长要求
返回 "Video duration can not longer than"识别为参考视频时长超限（非生成时长），提示用户裁剪视频而非重试
API 调用失败 / 超时重试 1 次，仍失败返回错误
内容合规拦截直接返回合规提示，不重试
Deliver

mv {file} {output_dir}/{date}_{name}_content-replace.mp4

Output

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

基线 Task ID

t_mt1a3i5n7b82954cc9-d2cb-44cd-a786-cb9fd37244f9

Comments

Markdown supported