前言¶
要在产品或内容流程里接入 AI 视频,常见做法是单独查火山引擎文档、自己封装异步任务轮询,再把模型 ID 和参数对齐到业务侧。对话式开发场景下,更希望把「选模型、填参数、等任务完成」收敛成 Agent 能执行的一套说明。下面介绍 SkillHub 社区 Skill seedance-video-generator(坐标 @user_a0ac60f2/seedance-video-generator2),它围绕火山引擎 Seedance API,覆盖文本到视频与图生视频,并标明异步任务处理方式。
这是什么¶
seedance-video-generator 是 SkillHub 上分类为 design-media 的社区 Skill,版本 1.0.0,发布者为 user_a0ac60f2。Skill 说明写明:使用火山引擎 Seedance API 生成视频,支持文本到视频和图生视频,采用异步处理任务,并包含完整的模型列表与参数配置。页面标签 requires_api_key=true,使用前需准备火山引擎侧 API 密钥,具体字段名以安装后 Skill 目录内的 SKILL.md 为准。
核心功能¶
依据 SkillHub 公开说明,已核实能力如下。
文本到视频(T2V)
| 模型 ID | 别名 |
|---|---|
doubao-seedance-1-0-pro-fast-251015 |
pro_fast |
doubao-seedance-1-0-t2v-250428 |
standard |
doubao-seedance-1-0-lite-t2v-250428 |
lite |
图生视频(I2V)
| 模型 ID | 别名 |
|---|---|
doubao-seedance-1-0-pro-250528 |
pro |
doubao-seedance-1-0-lite-i2v-250428 |
lite |
生成流程为异步:提交任务后需按 Skill 指引轮询或等待完成,再取回视频结果。不同别名对应速度与质量档位,选型时可在对话中直接指定模型 ID 或别名。
安装与启用¶
SkillHub 官方页面给出的安装方式是:让 Agent 按 SkillHub 安装说明 安装坐标 @user_a0ac60f2/seedance-video-generator2。
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、安装到当前 Agent 的 skills 目录
安装时必须用 --dir 指向当前环境会被识别的 skills 目录,否则默认落在 ./skills/ 可能无法被 Agent 加载。
skillhub install @user_a0ac60f2/seedance-video-generator2 --dir <skills 目录>
常见路径(来自 SkillHub 安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
安装完成后按所用客户端要求重启或刷新 Skill 列表。API Key 配置方式以 Skill 包内 SKILL.md 为准;标签已标明需要 API Key,请勿将密钥写入仓库或对话日志。
典型用法¶
公开页面未附带独立 REST 示例;Skill 采用通用 SKILL.md 格式,安装后由 Agent 读取其中的参数说明与调用步骤。可复现的用法模式如下。
- 确认火山引擎 Seedance API 密钥已按
SKILL.md配置。 - 在 Cursor、Claude Code 等已加载该 Skill 的会话中,用自然语言说明任务类型与内容,例如:文生视频、提示词、期望使用的模型别名(如
pro_fast/lite),或图生视频并说明参考图来源。 - 让 Agent 按 Skill 指引选择对应模型 ID、提交异步任务,并在完成后返回视频地址或本地路径(以 Skill 实现为准)。
文生视频与图生视频应分别选用上表中的 T2V 或 I2V 模型,避免混用模型系列。
适用场景与注意¶
适合谁
- 已在火山引擎开通 Seedance、希望从 IDE 内用对话驱动试片与迭代的开发者或创作者。
- 需要在 Agent 工作流里统一维护「模型列表 + 参数」、减少手写对接代码的团队。
限制与注意
- 依赖外网 API 与有效 API Key;配额、计费与合规以火山引擎控制台为准。
- 异步任务耗时不固定,长视频或高峰时段需预留等待时间。
- Skill 为社区来源(
community),升级与问题反馈通过 SkillHub 坐标与发布者渠道处理;安装前可在 SkillHub 查看版本与说明是否更新。
SkillHub 页面当前统计(以抓取时为准):评分 100000,下载 941,安装 50。
结尾¶
seedance-video-generator 把火山引擎 Seedance 的文生视频、图生视频模型清单和异步任务流程封装成 Agent Skill,适合在对话里完成选型与生成,而不必每次从零翻 API 文档。安装与坐标以 SkillHub 为准:
- Skill 页面:https://www.skillhub.cn/skills/user_a0ac60f2/seedance-video-generator2
- API 资源地址:https://api.skillhub.cn/user_a0ac60f2/seedance-video-generator2