- name
- vidu-template-generate
- version
- 1.0.0
- description
- Vidu AI 场景特效生成。支持389个预设特效模板，包括华丽变身、情人节、风格魔盒、缤纷佳节等。对话式调用，自动匹配模板。
Vidu Template Generate ✨
Vidu AI 场景特效生成工具，专注于特效模板功能。
环境说明
变量说明：
{baseDir}- 运行时自动替换为本 skill 目录的绝对路径
- 实际路径：~/.openclaw/workspace/skills/vidu-template-generate/
环境变量：
VIDU_API_KEY- Vidu API 密钥（必需）
快速开始
直接告诉我你想要什么特效，我会自动匹配模板：
"帮我生成一个拥抱特效"
"变身肌肉男"
"异域公主特效"
"拾取微缩分身"重要规则
⚠️ 严格使用用户的照片
- ✅ 必须使用用户上传的照片
- ✅ 如果用户没有提交照片，必须提醒用户上传
- ❌ 禁止使用默认图片或测试图片
特效模板分类
🎭 华丽变身 (14个)
| 特效名称 | 模板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 | 自信走上雪中红毯 |
💕 情人节 (10个)
| 特效名称 | 模板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 | 情侣亲密挥手友好 |
🎉 缤纷佳节 (8个)
| 特效名称 | 模板ID | 效果说明 |
|---|---|---|
| 樱花飘落 | sakura_season | 樱花飘落，抬头微笑 |
| 童年回忆 | youth_rewind | 童年春节怀旧欢乐场景 |
| 古风换装 | dynasty_dress | 换上古风服装 |
| 变身为圣诞老人 | christmas | 变身圣诞老人 |
| 圣诞老人来送礼 | christmas | 圣诞老人来送礼 |
| 圣诞节举杯庆祝 | christmas | 举香槟庆祝圣诞 |
| 圣诞老人来拥抱 | christmas | 圣诞老人来拥抱 |
| 全家福比心 | love_pose | 全家福比心 |
🎪 趣味工坊 (6个)
| 特效名称 | 模板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- 狼首男友
API 调用
内部使用 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/ - 返回格式: Markdown 格式引用文件
- 视频链接: 必须返回 Vidu API 的
creations[0].url字段
环境配置
必需环境变量：
VIDU_API_KEY=your_api_key_here获取 API Key：
- Vidu 官方开放平台：https://platform.vidu.cn 或 https://platform.vidu.com
- 注册账号后在「API Keys」页面创建
API 域名选择
重要规则：根据用户语言自动选择 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.cn - 用户使用其他语言（英文、日文、韩文等） → 使用
api.vidu.com
错误处理
| 错误 | 原因 | 解决方案 |
|---|---|---|
| Invalid API key | API密钥错误 | 检查 VIDU_API_KEY 环境变量 |
| Image size exceeds | 图片过大 | 压缩至50MB以下 |
| Task failed | 生成失败 | 查看 error 信息重试 |
| Template not found | 模板不存在 | 检查模板ID是否正确 |
References
Rules
- API Key 检查: 调用前确认
VIDU_API_KEY已设置 - 异步任务: 特效生成异步进行，需轮询状态
- 下载时效: 生成 URL 24小时内有效
- 返回视频链接: 必须返回视频 URL 让用户直接访问
- 严格使用用户照片: 必须使用用户上传的照片，禁止使用默认图片