前言¶
做短视频、产品演示或创意分镜时，往往要在控制台和脚本之间来回切换：选模型、传图、等任务、再下载结果。若希望对话式开发环境里直接发起文生视频、图生视频等任务，需要把 Vidu 开放平台的接口和参数约定封装成 Agent 能读懂的 Skill。下面介绍 SkillHub 上的 Vidu-视频生成（@vidu/vidu-video-generate-2），它把 Vidu 侧多种生成模式收敛到一套技能说明里，由 Agent 按 SKILL.md 调用。
这是什么¶
Vidu-视频生成 是北京生数科技股份有限公司在 SkillHub 发布的 enterprise 来源技能，分类为 design-media，当前版本 1.2.0。技能坐标为 @vidu/vidu-video-generate-2。
它面向的是已在或计划使用 Vidu 开放平台 的开发者：在支持 Skills 的 AI 客户端中安装后，Agent 可依据技能文档使用 Vidu 的视频生成能力，而不必每次手写完整 API 流程。技能标签标明 requires_api_key=true，使用前需准备 Vidu 开放平台 API Key，并在运行环境中按技能要求配置。
核心功能¶
以下能力均来自 SkillHub 与官方技能页简介，未单独列出的接口细节以安装后技能包内文档为准。
- 文生视频：根据文本提示生成视频。
- 图生视频：以输入图像为起点生成视频。
- 参考生视频：在参考素材约束下生成视频。
- 首尾帧生视频：由首帧、尾帧等约束控制生成过程。
- 模型版本：支持使用 Vidu 开放平台提供的所有模型版本（具体可选列表以 Vidu 平台与技能内说明为准）。
安装与启用¶
SkillHub 页面给出的安装方式是：先按通用安装说明配置 skillhub CLI，再安装本技能。
1. 检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可使用官方安装脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装 Vidu-视频生成¶
安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则技能可能落在默认 ./skills/ 而不会被识别。
skillhub install @vidu/vidu-video-generate-2 --dir <你的 skills 目录>
常见客户端 skills 路径（来自 SkillHub 安装文档，按你当前使用的工具选用其一）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将安装说明直接发给 Agent，例如：「请根据 https://skillhub.cn/install/skillhub.md，安装 @vidu/vidu-video-generate-2。」
3. API Key¶
技能标记为需要 API Key。请在 Vidu 开放平台申请密钥，并按技能包内 SKILL.md 及配套配置说明写入环境变量或配置文件（字段名以技能文档为准）。未配置密钥时，生成请求无法通过平台鉴权。
安装或更新技能后，若客户端未自动加载新技能，按所用产品的说明重启或刷新 Agent 会话。
典型用法¶
公开页面未提供独立可复制的一键示例脚本；实际流程遵循「安装技能 → 配置 Vidu API Key → 在对话中说明任务」：
- 确认
skillhub已将@vidu/vidu-video-generate-2安装到正确的 skills 目录。 - 在对话中明确模式与素材，例如：「用 Vidu 技能做文生视频，提示词是……」或「用这张图做图生视频」；参考生视频、首尾帧生视频需一并提供平台要求的参考图、首帧、尾帧等输入。
- Agent 读取技能内的参数与调用约定，向 Vidu 开放平台发起任务；生成结果的处理方式（轮询、下载链接等）以技能文档与 Vidu API 行为为准。
若需核对技能元信息，可打开 SkillHub 技能页查看名称、版本与简介是否与本地安装一致。
适用场景与注意¶
适合谁
- 已在 Vidu 开放平台开通账号、需要把视频生成嵌进 Cursor、Claude Code、Codex 等 Agent 工作流的设计、媒体与产品团队。
- 希望在同一对话里切换文生、图生、参考生、首尾帧等多种模式，并沿用平台侧模型版本的开发者。
需要注意
- 来源为 enterprise，使用与合规要求以 SkillHub 及发布方说明为准。
- 技能依赖外网调用 Vidu API；Key 勿提交到公开仓库。
- SkillHub 页面上该技能评分为 100000，下载 870 次（统计随平台更新变化）；安装计数在抓取时为 0，仅作商店展示参考。
- 官方技能 API 地址
https://api.skillhub.cn/vidu/vidu-video-generate-2在浏览器直接访问可能返回非文档内容；安装与浏览请以 SkillHub 技能页与skillhub install为准。
结尾¶
Vidu-视频生成 把 Vidu 开放平台的文生视频、图生视频、参考生视频、首尾帧生视频及全量模型版本选择，封装为 Agent 可执行的 Skill，适合在已配置 API Key 的前提下做对话式视频生产。技能信息与安装入口：
- 官方地址：https://api.skillhub.cn/vidu/vidu-video-generate-2
- SkillHub 页面：https://www.skillhub.cn/skills/vidu/vidu-video-generate-2
- 通用安装说明：https://skillhub.cn/install/skillhub.md
