Vidu AI 场景特效生成工具，专注于特效模板功能。
变量说明：
{baseDir} - 运行时自动替换为本 skill 目录的绝对路径~/.openclaw/workspace/skills/vidu-template-generate/环境变量：
VIDU_API_KEY - Vidu API 密钥（必需）直接告诉我你想要什么特效，我会自动匹配模板：
"帮我生成一个拥抱特效"
"变身肌肉男"
"异域公主特效"
"拾取微缩分身"
⚠️ 严格使用用户的照片
| 特效名称 | 模板ID | 效果说明 |
|---|---|---|
| --------- | -------- | --------- |
| 变身肌肉男 | muscling | 主角变身肌肉男，脱衣秀肌肉 |
| 变身美队 | captain_america | 变身美国队长，展开翅膀拿盾牌 |
| 变身浩克 | hulk | 破碎重塑狂暴红巨人 |
| 美队同行 | cap_walk | 与美队并肩赴战场 |
| 浩克俯冲 | hulk_dive | 主体乘浩克俯冲震地 |
| 异域公主 | exotic_princess | 变身异域公主盛装优雅出镜 |
| 与兽为伍 | beast_companion | 与兽人并肩自信前行 |
| 变身Q版玩偶 | cartoon_doll | 角色变身Q版玩偶 |
| 流金岁月 | golden_epoch | 进入鎏金岁月怀旧氛围 |
| 金像盛典 | oscar_gala | 持小金人发表获奖感言 |
| 时尚T台 | fashion_stride | T台自信走秀显气场 |
| 星光红毯 | star_carpet | 自信走上星光红毯 |
| 烈焰红毯 | flame_carpet | 优雅走上烈焰红毯 |
| 风雪红毯 | frost_carpet | 自信走上雪中红毯 |
| 特效名称 | 模板ID | 效果说明 |
|---|---|---|
| --------- | -------- | --------- |
| 法式热吻 | french_kiss | 两人交织热吻深沉热烈 |
| 梦幻婚礼 | dreamy_wedding | 进入新人梦幻婚礼 |
| 浪漫公主抱 | romantic_lift | 浪漫公主抱 |
| 温馨求婚 | sweet_proposal | 单膝跪地求婚惊喜 |
| AI情侣送花 | couple_arrival | 伴侣送花温馨互动 |
| 丘比特之箭 | cupid_arrow | 丘比特箭射出心动浪漫氛围 |
| 萌宠恋人 | pet_lovers | 萌宠情侣亲密互动 |
| AI情侣拥抱 | couple_arrival | 伴侣温暖拥抱 |
| AI情侣亲吻 | couple_arrival | 情侣接吻展现温馨氛围 |
| AI情侣挥手 | couple_arrival | 情侣亲密挥手友好 |
| 特效名称 | 模板ID | 效果说明 |
|---|---|---|
| --------- | -------- | --------- |
| 樱花飘落 | sakura_season | 樱花飘落，抬头微笑 |
| 童年回忆 | youth_rewind | 童年春节怀旧欢乐场景 |
| 古风换装 | dynasty_dress | 换上古风服装 |
| 变身为圣诞老人 | christmas | 变身圣诞老人 |
| 圣诞老人来送礼 | christmas | 圣诞老人来送礼 |
| 圣诞节举杯庆祝 | christmas | 举香槟庆祝圣诞 |
| 圣诞老人来拥抱 | christmas | 圣诞老人来拥抱 |
| 全家福比心 | love_pose | 全家福比心 |
| 特效名称 | 模板ID | 效果说明 |
|---|---|---|
| --------- | -------- | --------- |
| 解压切切 | slice_therapy | 解压切一切 |
| 变成气球飞走了 | balloon_flyaway | 变身气球旋转飞走 |
| 飞行 | flying | 变身超级英雄漂浮飞行 |
| 纸片人特效 | paperman | 主体变纸片人被大手移出 |
| 捏捏 | pinch | 大手捏扁主体 |
| 甜美微笑 | live_photo | 面对镜头露出甜美微笑 |
完整模板列表: 见 references/template_list.md (389个特效)
exotic_princess支持 area 参数指定公主类型：
auto - 随机生成denmark - 丹麦公主uk - 英国公主africa - 非洲公主china - 中国公主mexico - 墨西哥公主switzerland - 瑞士公主russia - 俄罗斯公主ital - 意大利公主korea - 韩国公主thailand - 泰国公主india - 印度公主japan - 日本公主beast_companion支持 beast 参数指定兽人类型：
auto - 随机生成bear - 熊首男友tiger - 虎首男友elk - 鹿首男友snake - 蛇首男友lion - 狮首男友wolf - 狼首男友内部使用 Python CLI 工具：
# 场景特效
python3 {baseDir}/scripts/vidu_cli.py template \
--template muscling \
--image user_photo.jpg \
--prompt "视频描述"
# 异域公主（指定中国公主）
python3 {baseDir}/scripts/vidu_cli.py template \
--template exotic_princess \
--image user_photo.jpg \
--prompt "视频描述"
# 与兽为伍（指定狼首男友）
python3 {baseDir}/scripts/vidu_cli.py template \
--template beast_companion \
--image user_photo.jpg \
--prompt "视频描述"
# 查询任务状态
python3 {baseDir}/scripts/vidu_cli.py status <task_id> --download ./uploads
{baseDir}/uploads/creations[0].url 字段必需环境变量：
VIDU_API_KEY=your_api_key_here
获取 API Key：
重要规则：根据用户语言自动选择 API 域名
| 用户语言 | API 域名 | 说明 |
|---|---|---|
| --------- | --------- | ------ |
| 简体中文 | api.vidu.cn | 国内用户（默认） |
| 其他语言 | api.vidu.com | 海外用户 |
Base URL 配置：
# 简体中文用户
BASE_URL = "https://api.vidu.cn/ent/v2"
# 非简体中文用户（英文、日文、韩文等）
BASE_URL = "https://api.vidu.com/ent/v2"
判断逻辑：
api.vidu.cnapi.vidu.com| 错误 | 原因 | 解决方案 |
|---|---|---|
| ------ | ------ | ---------- |
| Invalid API key | API密钥错误 | 检查 VIDU_API_KEY 环境变量 |
| Image size exceeds | 图片过大 | 压缩至50MB以下 |
| Task failed | 生成失败 | 查看 error 信息重试 |
| Template not found | 模板不存在 | 检查模板ID是否正确 |
VIDU_API_KEY 已设置共 1 个版本