video-content-replace
Skill33 starsChanged 5 months agoMITView on GitHub
使用 meitu-cli 替换视频中的内容元素(人物/场景/服装/衣物),保留原始运镜和动作,支持文本指令和参考图驱动。当用户提到视频替换、改视频内容、把视频里的 xx 改成、把视频背景换成、用这张图替换视频里的人、参考图替换时触发。
- Reads credentials
In this repository55 other files it gives its agents.
- meitu-toolsSkill
- SKILL.mdSkill
- audio-music-generateSkill
- audio-song-generateSkill
- image-background-replaceSkill
- image-cutoutSkill
- image-denoise-enhanceSkill
- image-editSkill
- image-element-removeSkill
- image-face-swapSkill
- image-grid-splitSkill
- image-id-photo-generateSkill
- image-lowlight-enhanceSkill
- image-outfit-swapSkill
- image-portrait-generateSkill
- image-poster-generateSkill
- image-searchSkill
- image-style-transferSkill
- image-superres-enhanceSkill
- image-text-replaceSkill
- image-to-videoSkill
- image-transformSkill
- meitu-beautySkill
- meitu-carouselSkill
- meitu-cutoutSkill
- meitu-game-2d-assetsSkill
- meitu-id-photoSkill
- meitu-image-adaptSkill
- meitu-image-fixSkill
- meitu-posterSkill
- meitu-product-swapSkill
- meitu-product-viewSkill
- meitu-stickersSkill
- meitu-upscaleSkill
- meitu-video-danceSkill
- meitu-visual-meSkill
- text-code-editSkill
- text-codeSkill
- text-generateSkill
- text-to-imageSkill
- text-to-videoSkill
- video-audio-addSkill
- video-canvas-expandSkill
- video-denoise-enhanceSkill
- video-effect-applySkill
- video-element-removeSkill
- video-framerate-enhanceSkill
- video-logo-addSkill
- video-lowlight-enhanceSkill
- video-motion-transferSkill
- video-multimodal-generateSkill
- video-quality-enhanceSkill
- video-resolution-upscaleSkill
- video-stitchSkill
- video-to-gifSkill
The file
Files
Video Content Replace
Overview
对已有视频做内容元素替换(人物/场景/服装/衣物/穿着),保留原始运镜和动作,覆盖 2 类场景:
- 文本指令替换:文本指令驱动视频内容修改,无需额外参考图。
- 参考图驱动替换:用户提供参考图 + 视频,按参考图替换视频中对应元素。
不处理:视频生成、去水印/去字幕、整体风格变换、音频修改、视频拼接。
API Mapping
| 场景 | API name | model |
| 文本指令替换 | video_molasses_edit | molasses |
| 参考图驱动替换 | video_molasses_vidimgs2vid | molasses |
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 → DeliverPreflight
meitu --version与meitu auth verify --json- 检测
MEITU_OPENAPI_TOOL_TASK_MODE=command - output_dir:项目 →
./output/;一次性 →$VISUAL/output/video-content-replace/;mkdir -p
Execute
触发信号与路由
核心判断维度:是否提供参考图。
| 场景 | 判定 | 路由 |
| 有参考图 + 替换元素 | 有 image_url | video_molasses_vidimgs2vid |
| 无参考图 + 文本指令 | 无 image_url | video_molasses_edit(默认) |
路由原则:image_url 存在时优先走参考图模式,即使用户说"用文字描述修改"也走 vidimgs2vid。
参数定义
| 参数 | 类型 | 必填 | 范围 | 默认 | 说明 |
video_url | STRING | 是 | 见下方约束 | — | 原视频地址 |
prompt | STRING | 是 | — | — | 修改描述 |
image_url | STRING | 否 | — | — | 参考图 URL;存在时路由至 vidimgs2vid |
model | STRING | 否 | auto/molasses | auto | 模型选择 |
其余参数(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
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

