Skill: x-jihua/vidu-video-generate (version 1.0.0)

--- name: vidu-video-generate version: 1.0.0 description: "Vidu AI 视频生成。支持文生视频、图生视频、参考生视频、首尾帧视频。对话式调用，自动识别意图。" --- # Vidu Video Generate 🎬 Vidu AI 视频生成工具，专注于视频生成功能。 ## 环境说明 **变量说明**： - `{baseDir}` - 运行时自动替换为本 skill 目录的绝对路径 - 实际路径：`~/.openclaw/workspace/skills/vidu-video-generate/` **环境变量**： - `VIDU_API_KEY` - Vidu API 密钥（必需） ## 快速开始 直接告诉我你想生成什么视频，我会自动识别并调用合适的接口： ``` "生成一只猫咪在阳光下打哈欠的视频" "把这个图片变成视频，让人物转头微笑" "用这两张图生成一个合照视频" "用首尾帧图片生成过渡动画" ``` ## 支持的视频类型 | 类型 | 触发条件 | 说明 | |------|----------|------| | 文生视频 | 纯文字描述 | 从文字生成视频 | | 图生视频 | 提供图片 + 描述 | 图片作为首帧生成视频 | | 参考生视频 | 多张图片 | 多人/多主体视频 | | 首尾帧视频 | 提供首帧+尾帧图片 | 过渡动画视频 | ## 自动识别规则 ``` 用户输入 → 意图识别 ───────────────────────────── 纯文字描述 → 文生视频 (text2video) 单张图片 + 描述 → 图生视频 (img2video) 多张图片 → 参考生视频 (ref2video) 首帧 + 尾帧 → 首尾帧视频 (start-end2video) ``` ## 模型选择策略 ### 文生视频模型 | 模型 | 时长范围 | 分辨率 | 特点 | |------|----------|--------|------| | viduq3-pro-fast | 默认5秒，可选1-16秒 | 默认720p，可选720p/1080p | 支持音画同步，支持视频分镜，效果对标viduq3-pro，生成速度更快 | | viduq3-turbo | 默认5秒，可选1-16秒 | 默认720p，可选540p/720p/1080p | 支持音画同步，支持视频分镜，生成速度更快 | | viduq3-pro | 默认5秒，可选1-16秒 | 默认720p，可选540p/720p/1080p | 支持音画同步，支持视频分镜，效果更好 | | viduq2 | 默认5秒，可选1-10秒 | 默认720p，可选540p/720p/1080p | 最新模型，情绪表达强，细节更丰富 | | viduq1 | 固定5秒 | 固定1080p | 画面清晰，平滑转场，运镜稳定 | ### 图生视频模型 > **必须输入1张图片** | 模型 | 时长范围 | 分辨率 | 特点 | |------|----------|--------|------| | viduq3-pro-fast | 默认5秒，可选1-16秒 | 默认720p，可选720p/1080p | 支持音画同步，支持生成分镜视频，效果对标viduq3-pro，生成速度最快 | | viduq3-turbo | 默认5秒，可选1-16秒 | 默认720p，可选540p/720p/1080p | 支持音画同步，支持生成分镜视频，生成速度更快 | | viduq3-pro | 默认5秒，可选1-16秒 | 默认720p，可选540p/720p/1080p | 支持音画同步，支持生成分镜视频，效果更好 | | viduq2-pro-fast | 默认5秒，可选1-10秒 | 默认720p，可选720p/1080p | 价格触底、效果好，生成速度在q2-turbo基础上提升2-3倍 | | viduq2-pro | 默认5秒，可选1-10秒 | 默认720p，可选540p/720p/1080p | 新模型，情感表达强，动态细节丰富 | | viduq2-turbo | 默认5秒，可选1-10秒 | 默认720p，可选540p/720p/1080p | 新模型，效果好，生成快 | | viduq1 | 固定5秒 | 固定1080p | 画面清晰，平滑转场，运镜稳定 | | viduq1-classic | 固定5秒 | 固定1080p | 画面清晰，转场、运镜更丰富 | | vidu2.0 | 默认4秒，可选4/8秒 | 4秒：默认360p，可选360p/720p/1080p<br>8秒：默认720p，可选720p | 生成速度快 | ### 参考生视频模型 | 模型 | 图片上限 | 时长范围 | 分辨率 | 特点 | |------|----------|----------|--------|------| | **viduq3-beta** | 5张 | 3-10秒 | 默认720p，可选540p/720p/1080p | **默认**，最新模型，支持音画同出，智能切镜 | | viduq3 | 7张 | 3-16秒 | 默认720p，可选540p/720p/1080p | 多人场景，智能切镜，支持更多图片 | | viduq2-pro | 7张 | 1-10秒* | 默认720p，可选540p/720p/1080p | 支持参考视频，支持视频编辑，视频替换 | | viduq2 | 7张 | 1-10秒 | 默认720p，可选540p/720p/1080p | 动态效果好，生成细节丰富 | | viduq1 | 7张 | 5秒 | 固定1080p | 画面清晰，平滑转场，运镜稳定 | | vidu2.0 | 7张 | 4秒 | 默认360p，可选360p/720p | 生成速度快 | > *viduq2-pro：输入视频时若未指定时长，duration=0 表示智能指定时长 ### 首尾帧视频模型 > **必须输入2张图片（首帧+尾帧）** | 模型 | 时长范围 | 分辨率 | 特点 | |------|----------|--------|------| | viduq3-pro-fast | 默认5秒，可选1-16秒 | 默认720p，可选720p/1080p | 支持音画同步，支持生成分镜视频，效果对标viduq3-pro，生成速度最快 | | viduq3-turbo | 默认5秒，可选1-16秒 | 默认720p，可选540p/720p/1080p | 支持音画同步，支持生成分镜视频，生成速度更快 | | viduq3-pro | 默认5秒，可选1-16秒 | 默认720p，可选540p/720p/1080p | 支持音画同步，支持生成分镜视频，效果更好 | | viduq2-pro-fast | 默认5秒，可选1-10秒 | 默认720p，可选720p/1080p | 价格触底、效果好，生成速度在q2-turbo基础上提升2-3倍 | | viduq2-pro | 默认5秒，可选1-10秒 | 默认720p，可选540p/720p/1080p | 新模型，效果好，细节丰富 | | viduq2-turbo | 默认5秒，可选1-10秒 | 默认720p，可选540p/720p/1080p | 新模型，效果好，生成快 | | viduq1 | 固定5秒 | 固定1080p | 画面清晰，平滑转场，运镜稳定 | | viduq1-classic | 固定5秒 | 固定1080p | 画面清晰，转场、运镜更丰富 | | vidu2.0 | 默认4秒，可选4/8秒 | 4秒：默认360p，可选360p/720p/1080p<br>8秒：默认720p，可选720p | 生成速度快 | ## 时长与分辨率默认值 ``` 视频时长：5秒 视频分辨率：720p 视频比例：16:9 ``` ## API 调用 内部使用 Python CLI 工具： ```bash # 文生视频 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` 字段 ## 环境配置 必需环境变量： ```bash 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 配置**： ```python # 简体中文用户 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 信息重试 | ## References - [API参考文档](references/api_reference.md) - 所有API详细参数 ## Rules 1. **API Key 检查**: 调用前确认 `VIDU_API_KEY` 已设置 2. **异步任务**: 视频生成异步进行，需轮询状态 3. **下载时效**: 生成 URL 24小时内有效 4. **返回视频链接**: 必须返回视频 URL 让用户直接访问


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector:  ()