seedance 2.0:在 Agent 里调用 ByteDance Seedance 2.0 视频生成

前言

在 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 与官方简介,可按命令行参数组合使用。

  1. 多模态参考(generation_mode=components,默认)
    - --images:最多 9 张参考图(URL 或本地路径)
    - --videos:最多 3 段参考视频
    - --audios:最多 3 段参考音频

  2. 首尾帧模式(generation_mode=frames)
    - --firstFrame、--lastFrame:首帧与尾帧图像,用于控制起止画面。

  3. 文生视频
    - 通过必填的 --prompt 描述画面;可与上述模式配合(首尾帧模式下不传 images/videos/audios 参考项)。

  4. 输出与画幅
    - 分辨率:480p / 720p(默认) / 1080p
    - 比例:21:9、16:9(默认)、4:3、1:1、3:4、9:16
    - 时长:4–15 秒(默认 5 秒)
    - --generate_audio:是否生成音频(默认 true)

  5. 任务控制
    - --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)行为一致。
  • 需要多参考图/音视频、首尾帧或可调分辨率与画幅的短视频生成流水线。

限制与注意

  1. 付费与密钥:依赖 dLazy 账户余额;insufficient_balance 时需到控制台充值;未配置 Key 会返回 unauthorized。
  2. 数据出境:提示词与上传的本地媒体会进入 dLazy 云端,需符合你方数据合规要求。
  3. 依赖环境:需 Node 生态下的 npm/npx;Skill 为社区发布,与 ByteDance 官方无 SkillHub「作者认证」绑定,使用前可在 github.com/dlazyai/cli 审阅 CLI 源码。
  4. 安全扫描: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
羽毛球分组比赛记分
小程序二维码

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

小夜