# Childwear Videoedit

> 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

- Skill: `zhuwei1998/childwear-videoedit` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add zhuwei1998/childwear-videoedit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhuwei1998/childwear-videoedit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zhuwei1998 (https://skillmd.com/u/zhuwei1998)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zhuwei1998/childwear-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/`

```bash
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：
```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` 重新查询 |

## 调试

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

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