childwear-videoedit

name	childwear-videoedit
description	Use when user wants to edit a video by replacing/changing the person in it with a person from a reference image, change clothes, or apply style transfer. Calls 阿里云百炼 wan2.7-videoedit. 触发词：换装, 换人物, 视频编辑, 视频换脸, 把视频里的人换成图里的, 童装带货, 模特替换, 模特换装, 视频里换衣服, 给视频换人, video edit, person swap, replace person, change clothes, video style transfer, 万相, wan2.7, videoedit

童装带货视频编辑（wan2.7-videoedit）

调用阿里云百炼 wan2.7-videoedit 模型，指令式编辑视频（换人/换装/风格迁移），保留原视频背景与音频。典型用例：童装带货——把模特视频里的人替换为另一张参考图里的人。

Quick Reference

参数	说明	必需	默认值
--video	视频路径或 URL（本地文件会自动上传 OSS）	是	-
--image	参考图路径或 URL（可选，无则纯指令编辑）	否	-
--prompt	文本指令（中英文，≤5000 字符）	是	-
--resolution	输出分辨率：720P(¥0.6/秒) 或 1080P(¥1/秒)	否	720P
--audio-setting	origin(保留原声) 或 auto(智能)	否	origin
--duration	截断输出时长（秒，[2,10]）	否	跟原视频
--json	以 JSON 格式输出结果（推荐 OpenClaw 用）	否	false

调用方式（OpenClaw 子进程）

固定路径：/home/gem/workspace/agent/skills/childwear-videoedit/

cd /home/gem/workspace/agent/skills/childwear-videoedit && \
python3 -m src.cli \
  --video "<URL or path>" \
  --image "<URL or path>" \
  --prompt "<text>" \
  --resolution 720P \
  --duration 5 \
  --json

成功输出 JSON：

{
  "success": true,
  "task_id": "...",
  "remote_video_url": "https://dashscope-...mp4?Expires=...",
  "local_video_path": "/home/gem/workspace/agent/skills/childwear-videoedit/output/20260430_xxx.mp4",
  "usage": {"duration": 10, "input_video_duration": 5, "output_video_duration": 5}
}

把 local_video_path 上传回飞书聊天即可（OpenClaw 会自动处理）。

输入要求

类型	限制
视频	mp4/mov，2-10 秒，≤100MB，分辨率 240-4096px，宽高比 1:8~8:1
参考图	jpg/png/bmp/webp，≤20MB，分辨率 240-8000px
Prompt	中英文都行，≤5000 字符

飞书使用流程

1. 用户在飞书私聊里发送：视频文件 + 参考图 + 文字指令（如"把视频里的人换成图里的"）
2. OpenClaw 把飞书文件下载下来或拿到 URL
3. 调用本 Skill：cli.py --video <文件路径或URL> --image <...> --prompt <用户原话>
4. 等待 1-12 分钟（视频长度决定）
5. Skill 返回 JSON，含 local_video_path
6. OpenClaw 把这个本地视频文件作为飞书消息发回

计费 & 免费额度

• 720P：¥0.6/秒，1080P：¥1/秒
• 计费 = 输入秒数 + 输出秒数（5 秒视频 720P = ¥6/次）
• 失败不扣费
• 新用户首 90 天送 50 秒免费额度（截至 2026-07-01）

推荐 Prompt 模板

场景	模板
整体换人	把视频里的女生换成图片里的女生，背景不变，只变动人物，背景音乐也不准变
换装	将视频中女孩的衣服替换为参考图中的衣服
风格化	将整个画面转换为黏土风格 / 卡通风格 / 黑白电影风格
加元素	给视频里的人加上参考图里的帽子

失败排查

错误	原因 / 解决
配置错误：DASHSCOPE_API_KEY 未配置	.env 文件缺失或未填，跑 cat .env 检查
OSS 连接失败	RAM 用户没有 AliyunOSSFullAccess 权限
视频过大: xMB > 100MB	输入视频超过 100MB，需压缩
任务未成功: status=FAILED	看 code/message，常见是输入素材不合规
下载超时	百炼返回的 URL 24 小时内有效，可用 task_id 重新查询

调试

# 不消费百炼，只走 OSS 上传 + 组装请求体
python3 -m src.cli ... --dry-run

# 查看详细日志
python3 -m src.cli ... --log-level DEBUG