前言¶
在 Cursor、Claude Code 等环境里做短视频原型,常见做法是手写火山引擎 Ark 请求、自己轮询任务再把文件落盘。参数(时长、比例、分辨率、模型档位)和提示词模板往往散落在脚本里,改一次就要动多处代码。
下面介绍 SkillHub 上的社区技能 seedance2-0(@user_1da200f4/seedance2-0,当前版本 1.0.4)。它把 Seedance 2.0 相关能力封装成 Agent 可读的 SKILL.md 与可执行脚本,用环境变量配置密钥,并约定生成前需向用户收集的参数字段。
这是什么¶
seedance2-0 定位为:基于字节跳动 Seedance 2.0 的 AI 视频生成技能,官方简介写明支持文生图、文生视频,并提供快速生成封装。
- 坐标:
@user_1da200f4/seedance2-0 - 来源:SkillHub 社区(
community) - 分类:
design-media - 发布者:
user_1da200f4 - 标签:
requires_api_key=true(使用前需配置 API 密钥)
SkillHub 页面当前展示:评分 100000,下载 1300 次(数据以 SkillHub 为准)。
官方入口:
- API 索引:https://api.skillhub.cn/user_1da200f4/seedance2-0
- 技能页:https://www.skillhub.cn/skills/user_1da200f4/seedance2-0
核心功能¶
以下能力均来自技能包内 SKILL.md 与实现脚本,可与安装后文档对照。
- 快速生成:封装 Ark API 调用,支持常见场景提示词模板(如宣传、活动预告、vlog、科普、营销等)的配置化组合。
- 参数可配:模型档位(
pro/fast/lite)、时长(5s / 10s / 15s)、画面比例(9:16 / 16:9 / 1:1)、分辨率(720p / 1080p)等。 - 结果落盘:生成后下载视频到本地,并产出可临时访问的链接(技能说明中的行为描述)。
- Agent 工作流约束:在用户要生成视频时,先按固定模板确认「视频内容、时长、比例、分辨率」四项入参,再执行生成。
默认模型 ID 为 doubao-seedance-2-0-260128;fast、lite 对应技能内配置的其它模型标识。
安装与启用¶
1. 安装 SkillHub CLI(若尚未安装)¶
先检查是否已有 CLI:
command -v skillhub && skillhub --version
未安装时,可按 SkillHub 安装文档执行完整安装(含默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
说明文档:https://skillhub.cn/install/skillhub.md
2. 安装 seedance2-0 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端识别的 skills 目录,否则默认装到 ./skills/ 可能不会被 Agent 加载。
skillhub install seedance2-0 --namespace user_1da200f4 --dir <你的 skills 目录>
常用路径(来自 SkillHub 安装说明):
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
也可在对话中让 Agent 按 https://skillhub.cn/install/skillhub.md 安装 @user_1da200f4/seedance2-0。
3. 配置环境与依赖¶
技能通过环境变量读取火山引擎 Ark 配置:
ARK_API_KEY:火山引擎 API 密钥(控制台获取)ARK_BASE_URL:默认https://ark.cn-beijing.volces.com/api/v3
可在技能目录下的 .env 中写入上述变量(实现脚本会通过 dotenv 加载)。
技能 package.json 中声明 OpenClaw 侧安装步骤为 bun install,运行入口为 bun seedance2.0.ts。若你的环境走脚本直跑,需本机具备 bun 并在技能目录执行依赖安装。
安装或更新 skills 后,按你所用客户端说明重启或刷新 Agent,使新技能被识别。
典型用法¶
在对话里触发(推荐)¶
技能文档给出的自然语言示例:
用seedance生成视频,提示词:...
生成前,Agent 应引导用户按下列模板补全参数:
视频内容:XXX
时长:5s/10s/15s
比例:9:16/16:9/1:1
分辨率:720p/1080p
可选扩展包括:模型选择(pro / fast / lite),以及技能实现里支持的参考图、参考视频、参考音频等字段(见 seedance2.0.ts 中的 SeedanceOptions)。
命令行(技能自带脚本)¶
在已安装的技能目录中,可通过 bun 运行主脚本(package.json 中 start / help 指向 seedance2.0.ts):
bun install
bun seedance2.0.ts --help
具体 CLI 参数以 --help 输出为准;调用前确保 ARK_API_KEY 已设置。
适用场景与注意¶
适合谁
- 已在火山引擎 Ark 开通 Seedance 2.0 相关能力,希望在 Agent 对话里完成「收集参数 → 调 API → 下载结果」闭环的开发者或创作者。
- 需要复用内置提示词模板(宣传、活动、vlog 等)快速出片,而不是每次从零写 HTTP 客户端的同学。
限制与注意
- 必须配置密钥:未设置
ARK_API_KEY时,脚本会报错退出;SkillHub 标签也标明requires_api_key=true。 - 合规与审核:技能要求遵守内容安全(涉黄、涉恐、涉敏等)及版权约束(未授权 IP、公众人物、版权音乐等),生成前应自检提示词与素材。
- 社区技能:来源为
community,集成前建议在 SkillHub 查看版本与说明,并在内网/生产环境按自有安全规范评估。 - 简介与实现侧重:商店简介提到文生图;当前包内
SKILL.md以文生视频流程与参数模板为主,文生图细节以安装后文档与脚本能力为准。
结尾¶
seedance2-0 把 Seedance 2.0 的视频生成封装成 Agent Skill:统一环境变量、默认模型与生成前参数清单,减少手写 Ark 调用的重复劳动。若你要在 Cursor 等环境里试 Seedance 2.0,可从 SkillHub 安装 @user_1da200f4/seedance2-0,配置 ARK_API_KEY 后按技能模板发起生成。
官方地址:https://www.skillhub.cn/skills/user_1da200f4/seedance2-0