meitu 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 → Deliver
Preflight
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