前言¶
在 IDE 或 CLI 里做视频生成,常见做法是单独打开控制台、手工上传参考素材、再复制任务 ID 轮询结果。流程长,也不方便把「写提示词 → 调模型 → 拿成片 URL」嵌进自动化脚本。
下面介绍 SkillHub 上的 seedance 2.0(坐标 @user_f95f21b8/dlazy-seedance-2-0,当前版本 1.0.9)。它把 dLazy CLI 与托管 API 封装成标准 Skill:Agent 按 SKILL.md 执行 dlazy seedance-2.0,即可走多模态参考、首尾帧或纯文本生成视频,而无需你每次手写 HTTP 请求。
这是什么¶
seedance 2.0 是社区来源(source: community)的 design-media 类 Skill,SkillHub 子分类为「视频处理」。页面简介写明:面向 ByteDance 最新视频生成模型,支持用图像、视频、音频作多模态参考生成视频,并支持首尾帧模式与文生视频。
技能本体不内置模型权重,而是 dLazy 托管 API 的薄客户端:提示词与参数发往 api.dlazy.com,本地参考文件由 CLI 上传到 files.dlazy.com,返回的成片 URL 同样托管在该域名。CLI 由 dlazyai 维护,npm 包为 @dlazy/cli(本 Skill 固定 1.0.9)。SkillHub 发布者为 user_f95f21b8(展示名 dLazy)。
截至 SkillHub 页面数据:下载约 2096 次,安装约 10 次;标签 requires_api_key=true,使用前必须配置 dLazy API Key。
核心功能¶
以下能力均来自 Skill 包内 SKILL.md / SKILL-cn.md 与官方简介,可按命令行参数组合使用。
-
多模态参考(
generation_mode=components,默认)
---images:最多 9 张参考图(URL 或本地路径)
---videos:最多 3 段参考视频
---audios:最多 3 段参考音频 -
首尾帧模式(
generation_mode=frames)
---firstFrame、--lastFrame:首帧与尾帧图像,用于控制起止画面。 -
文生视频
- 通过必填的--prompt描述画面;可与上述模式配合(首尾帧模式下不传 images/videos/audios 参考项)。 -
输出与画幅
- 分辨率:480p/720p(默认) /1080p
- 比例:21:9、16:9(默认)、4:3、1:1、3:4、9:16
- 时长:4–15 秒(默认 5 秒)
---generate_audio:是否生成音频(默认true) -
任务控制
---dry-run:只打印请求体与费用估算,不调用 API
---no-wait:异步返回generateId,可用dlazy status <generateId> --wait轮询
---timeout:等待异步完成的最长时间(默认 1800 秒)
后端模型标识在成功响应中为 modelId: "doubao-seedance-2_0"。
安装与启用¶
安装分两层:先把 Skill 装进 Agent 的 skills 目录,再确保本机有 dLazy CLI 与 API Key。
1. 通过 SkillHub 安装 Skill¶
若已安装 skillhub CLI,将 Skill 装到当前 Agent 识别的目录(必须使用 --dir,否则默认 ./skills/ 可能不会被加载):
skillhub install @user_f95f21b8/dlazy-seedance-2-0 --dir <你的 skills 目录>
常见路径(来自 SkillHub 安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下.agents/skills/
也可让 AI 按同一文档安装,提示词示例为:请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f95f21b8/dlazy-seedance-2-0。
未安装 skillhub 时,可先执行:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装 dLazy CLI¶
Skill 元数据要求本机具备 npm 与 npx。全局安装固定版本:
npm install -g @dlazy/cli@1.0.9
若不想全局安装,可按次调用:
npx @dlazy/cli@1.0.9 <command>
3. 配置 API Key¶
在 dlazy.com 注册后,于 组织 API Key 页面 复制密钥,写入 CLI:
dlazy auth set YOUR_API_KEY
密钥保存在 ~/.dlazy/config.json(Linux/macOS);也可用环境变量 DLAZY_API_KEY 按次传入。
典型用法¶
Agent 侧的核心指令是执行 dlazy seedance-2.0 获取结果。先查看完整参数:
dlazy seedance-2.0 -h
官方文档中的最小文生视频示例:
dlazy seedance-2.0 --prompt '提示词内容'
多模态参考时,在 components 模式下追加参考资源,例如本地图片与提示词(路径需真实存在,否则会触发本地文件读取错误):
dlazy seedance-2.0 \
--prompt '根据参考图风格生成一段短片' \
--images /path/to/reference.png \
--resolution 1080p \
--ratio 16:9 \
--duration 8
首尾帧示例思路相同,将 --generation_mode 设为 frames,并传入 --firstFrame / --lastFrame。
成功时 CLI 返回 JSON,result.tool 为 seedance-2.0,outputs 中含 url 等字段;使用 --no-wait 时需后续 dlazy status 查询。
适用场景与注意¶
适合谁
- 已在 Cursor、Claude Code、Codex 等环境使用 Skills,希望用自然语言驱动 Seedance 2.0 成片。
- 需要同一套 CLI 在终端与 Agent 间复用:参数、异步任务、费用预估(
--dry-run)行为一致。 - 需要多参考图/音视频、首尾帧或可调分辨率与画幅的短视频生成流水线。
限制与注意
- 付费与密钥:依赖 dLazy 账户余额;
insufficient_balance时需到控制台充值;未配置 Key 会返回unauthorized。 - 数据出境:提示词与上传的本地媒体会进入 dLazy 云端,需符合你方数据合规要求。
- 依赖环境:需 Node 生态下的
npm/npx;Skill 为社区发布,与 ByteDance 官方无 SkillHub「作者认证」绑定,使用前可在 github.com/dlazyai/cli 审阅 CLI 源码。 - 安全扫描:SkillHub 页面展示的安全报告状态为「安全,无风险」,仍建议只向 CLI 传入可信路径与 URL。
结尾¶
seedance 2.0 把 Seedance 2.0 的视频能力收敛成 Agent 可执行的 dlazy seedance-2.0 命令:多模态参考、首尾帧与文生视频在同一套参数模型下完成。若你正在 SkillHub 选型视频类 Skill,可从官方页面查看版本与统计信息:
- SkillHub:https://www.skillhub.cn/skills/user_f95f21b8/dlazy-seedance-2-0
- API 入口(Skill 线索页):https://api.skillhub.cn/user_f95f21b8/dlazy-seedance-2-0