meitu Video Stitch
Overview
调用 meitu video-stitch 对多段视频（≥2 段）做顺序拼接合并，覆盖 2 类：
- 纯拼接（保留原声）：
video_stitching，video_volume控制原声音量 - 拼接 + 配乐：
video_splicing_music，按prompt自动检索音乐；提供music_url时跳过检索直接使用自定义音乐
不支持自定义转场。不处理：单视频裁剪/调速、旁白配音、GIF 转换、视频风格变换。
API Mapping
| 场景 | 后端 API |
|---|---|
| 纯拼接保留原声 | video_stitching |
| 拼接 + 配乐（自动检索 / 自定义 music_url） | video_splicing_music |
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 - output_dir 解析：openclaw.yaml →
./output/| else →$VISUAL/output/video-stitch/；mkdir -p {output_dir}
Execute
触发信号/路由
命中信号词：
video_stitching（纯拼接）：拼接、合并、拼在一起、不需要音乐、保留原声video_splicing_music（拼接+配乐）：拼接并配乐、合并加音乐、拼接+自定义音乐 URL
决策顺序：
video_list数量 <2 → 提示"拼接需要至少 2 段视频"- Agent 识别视频素材生成
prompt辅助路由 - 按配乐需求分支：
- 不需要音乐 / 有原声 →
video_stitching（默认） - 需要配乐（无
music_url）→video_splicing_music+prompt自动检索 - 需要配乐（有
music_url）→video_splicing_music+music_url跳过检索
- 不需要音乐 / 有原声 →
意图模糊（"拼接处理一下"）→ 默认走 video_stitching。
参数定义
通用：
| 参数 | 类型 | 必填 | 范围 | 默认值 | 说明 |
|---|---|---|---|---|---|
video_list |
ARRAY[STRING] | 是 | ≥2 个 | -- | 视频地址列表 |
prompt |
STRING | 是 | -- | "music" | 音乐检索关键词 / 素材描述 |
video_volume |
NUMBER | 否 | 0–2.0 | 1 | 视频原声音量 |
video_splicing_music 额外：
| 参数 | 类型 | 必填 | 范围 | 默认值 | 说明 |
|---|---|---|---|---|---|
music_url |
STRING | 否 | -- | -- | 自定义音乐 URL；存在时跳过 prompt 自动检索 |
canvas_flag |
NUMBER | 否 | 0 / 1 | 0 | 0=竖屏(9:16)，1=横屏(16:9) |
API 参数映射
video_stitching：video_list → video_list；video_volume → video_volume（直传）
video_splicing_music：video_list → video_urls；prompt → content；video_volume、music_url、canvas_flag 直传
工具调用
纯拼接：
meitu video-stitch \
--skill_name skill_video-stitch \
--video_list '["{url1}","{url2}"]' \
--prompt "通用视频素材" \
--video_volume 1 \
--json --download-dir {output_dir}
拼接 + 自动配乐：
meitu video-stitch \
--skill_name skill_video-stitch \
--video_list '["{url1}","{url2}"]' \
--prompt "轻快的旅拍背景音乐" \
--json --download-dir {output_dir}
拼接 + 自定义音乐：
meitu video-stitch \
--skill_name skill_video-stitch \
--video_list '["{url1}","{url2}"]' \
--music_url "{music_url}" \
--canvas_flag 0 \
--json --download-dir {output_dir}
错误降级
| 场景 | 处理 |
|---|---|
video_list 缺失 |
提示"请提供视频链接" |
| 视频数量 <2 | 提示"拼接需要至少 2 段视频" |
| 部分链接不可访问 | 过滤无效链接，用剩余视频执行 |
| 全部不可访问 | 提示"请提供有效视频链接" |
music_url 不可访问 |
回退至 prompt 自动检索 |
video_volume 超 0–2.0 |
钳位到合法范围 |
canvas_flag 非 0/1 |
回退至默认 0（竖屏） |
| 用户要求"加转场效果" | 告知不支持自定义转场，使用默认硬切拼接 |
video_stitching 调用失败 |
重试 1 次，仍失败返回错误 |
video_splicing_music 调用失败 |
重试 1 次，仍失败返回错误 |
| 内容合规拦截 | 直接返回合规提示，不重试 |
同时提供 music_url + 风格 prompt |
优先用 music_url，prompt 仅辅助 |
Deliver
解析 --json → downloaded_files[0].saved_path 或 media_urls[0]。
mv {file} {output_dir}/{YYYY-MM-DD}_{name}_stitch.mp4
Output
- 格式：MP4（默认竖屏 9:16，可切横屏 16:9）
- 命名：
{YYYY-MM-DD}_{descriptive-name}_stitch.mp4 - 位置：项目 →
./output/；一次性 →$VISUAL/output/video-stitch/
基线 Task ID
t_mt1a3i5n7bc437c380-3bce-4dd3-9b62-67226da73d91