Vidu Video Generate 🎬

Vidu AI 视频生成工具，专注于视频生成功能。

环境说明

变量说明：
- {baseDir} - 运行时自动替换为本 skill 目录的绝对路径
- 实际路径：~/.openclaw/workspace/skills/vidu-video-generate/

环境变量：
- VIDU_API_KEY - Vidu API 密钥（必需）

快速开始

直接告诉我你想生成什么视频，我会自动识别并调用合适的接口：

"生成一只猫咪在阳光下打哈欠的视频"
"把这个图片变成视频，让人物转头微笑"
"用这两张图生成一个合照视频"
"用首尾帧图片生成过渡动画"

支持的视频类型

自动识别规则

用户输入 → 意图识别
─────────────────────────────
纯文字描述 → 文生视频 (text2video)
单张图片 + 描述 → 图生视频 (img2video)
多张图片 → 参考生视频 (ref2video)
首帧 + 尾帧 → 首尾帧视频 (start-end2video)

模型选择策略

文生视频模型

图生视频模型

> 必须输入1张图片

参考生视频模型

> *viduq2-pro：输入视频时若未指定时长，duration=0 表示智能指定时长

首尾帧视频模型

> 必须输入2张图片（首帧+尾帧）

时长与分辨率默认值

视频时长：5秒
视频分辨率：720p
视频比例：16:9

API 调用

内部使用 Python CLI 工具：

# 文生视频
python3 {baseDir}/scripts/vidu_cli.py text2video --prompt "视频描述"

# 图生视频
python3 {baseDir}/scripts/vidu_cli.py img2video --image photo.jpg --prompt "描述"

# 参考生视频
python3 {baseDir}/scripts/vidu_cli.py ref2video --images img1.jpg img2.jpg --prompt "描述"

# 首尾帧视频
python3 {baseDir}/scripts/vidu_cli.py start-end2video --start-frame start.jpg --end-frame end.jpg --prompt "描述"

# 查询任务状态
python3 {baseDir}/scripts/vidu_cli.py status <task_id> --wait --download ./uploads

输出规范

1. 下载目录: {baseDir}/uploads/
2. 返回格式: Markdown 格式引用文件
3. 视频链接: 必须返回 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 域名

Base URL 配置：

# 简体中文用户
BASE_URL = "https://api.vidu.cn/ent/v2"

# 非简体中文用户（英文、日文、韩文等）
BASE_URL = "https://api.vidu.com/ent/v2"

判断逻辑：
- 用户使用简体中文 → 使用 api.vidu.cn
- 用户使用其他语言（英文、日文、韩文等） → 使用 api.vidu.com

错误处理

References

• API参考文档 - 所有API详细参数

Rules

1. API Key 检查: 调用前确认 VIDU_API_KEY 已设置
2. 异步任务: 视频生成异步进行，需轮询状态
3. 下载时效: 生成 URL 24小时内有效
4. 返回视频链接: 必须返回视频 URL 让用户直接访问