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 让用户直接访问
- 严格使用用户照片: 必须使用用户上传的照片，禁止使用默认图片
