seedance2-0:在 Agent 里调用 Seedance 2.0 做文生视频

前言

在 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 与实现脚本,可与安装后文档对照。

  1. 快速生成:封装 Ark API 调用,支持常见场景提示词模板(如宣传、活动预告、vlog、科普、营销等)的配置化组合。
  2. 参数可配:模型档位(pro / fast / lite)、时长(5s / 10s / 15s)、画面比例(9:16 / 16:9 / 1:1)、分辨率(720p / 1080p)等。
  3. 结果落盘:生成后下载视频到本地,并产出可临时访问的链接(技能说明中的行为描述)。
  4. 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 客户端的同学。

限制与注意

  1. 必须配置密钥:未设置 ARK_API_KEY 时,脚本会报错退出;SkillHub 标签也标明 requires_api_key=true。
  2. 合规与审核:技能要求遵守内容安全(涉黄、涉恐、涉敏等)及版权约束(未授权 IP、公众人物、版权音乐等),生成前应自检提示词与素材。
  3. 社区技能:来源为 community,集成前建议在 SkillHub 查看版本与说明,并在内网/生产环境按自有安全规范评估。
  4. 简介与实现侧重:商店简介提到文生图;当前包内 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜