seedance-v2：字节跳动旗舰视频模型的安装、调用与 Agent 集成指南

🧩 它凭什么值得你花时间

2026 年 2 月 12 日，字节跳动正式发布了 Seedance 2.0。和上一代 1.5 版本相比，这一代的提升不是小修小补——它换了一套全新的底层架构，叫“统一的多模态音视频联合生成架构”。

这个架构名字听起来拗口，但它带来的实际变化很直观：视频和音频不再是分开生成再拼起来的，而是一起生成的。你不需要先出画面再配音，模型一次性给你带声音的成片。官方数据显示，它的声画时序误差控制在约 33 毫秒。

具体能力上看，Seedance 2.0 有几个硬指标：

• 多模态输入——同时接收最多 9 张图片、3 段视频、3 段音频，加上自然语言指令。它不只是一张图配一句话，而是可以同时参考多个素材的构图、动作、运镜、声音。
• 15 秒多镜头输出——支持 15 秒高质量多镜头音视频输出，具备双声道音频能力。
• 四档分辨率、六种画幅——480p、720p、1080p、4K 可选，画幅覆盖 21:9 到 9:16。
• 视频编辑与延长——不只是生成新视频，还能对已有视频做编辑和续写。

在复杂运动场景上，这一代的进步尤为明显。双人花样滑冰的同步起跳、空中旋转、精准落冰这类前代模型容易出物理错误的地方，Seedance 2.0 能保持对现实运动规律的遵循。

📦 三条安装路线，按你的工作流选

路线一：CLI 命令行工具（推荐给开发者和 Agent 用户）

社区维护的 seedance npm 包是基于火山引擎 Ark 平台的命令行工具，支持文生视频、图生视频、视频转视频和参考生视频四种模式。全局安装：

npm install -g seedance

安装后验证：

seedance --version

配置 API Key 是交互式的，执行后按提示输入即可：

seedance config init

如果你用 Claude Code、Cursor 或 Codex，还可以额外装一个 Skill，让 Agent 直接调用：npx skills add vaxin/seedance-cli。

路线二：ComfyUI 自定义节点（推荐给本地工作流用户）

如果你在 ComfyUI 里工作，可以通过自定义节点把 Seedance 2.0 接入现有的节点图。安装方式有两种，推荐用 ComfyUI Manager：打开 Manager → Install via Git URL → 粘贴 https://github.com/Anil-matcha/seedance2-comfyui → 安装并重启。

手动安装的话：

cd ComfyUI/custom_nodes
git clone https://github.com/Anil-matcha/seedance2-comfyui
pip install -r seedance2-comfyui/requirements.txt

装好之后需要去 muapi.ai 注册账号拿一个 API Key，在 ComfyUI 里添加 Seedance 2.0 API Key 节点填入即可。

路线三：MCP 服务器（适合 Claude Code / Cursor / Windsurf）

MeiGen AI Design MCP 是一个开源 MCP 服务器，支持 Seedance 2.0 在内的多个模型，兼容 Claude Code、Cursor、Codex、Windsurf、Roo Code 和 OpenClaw。推荐用远程 MCP 端点，零安装：

claude mcp add --transport http meigen https://www.meigen.ai/api/mcp \
  --header "Authorization: Bearer meigen_sk_YOUR_TOKEN"

如果你更倾向于本地 npm 安装，也可以用 npx -y meigen-ai-design-mcp 配合 stdio 方式接入。

🛠️ 装好之后怎么用

Seedance 2.0 的 API 不是单一模型，而是一个由 6 个模型组成的矩阵。调用时必须在 model 字段中精确指定其中之一，没有自动模式检测。这个矩阵按“输入类型 × 速度”两个维度划分：

选择逻辑很简单：先看你手里有什么输入——只有文字选 text-to-video，有 1 到 2 张图选 image-to-video，有图有视频有音频选 reference-to-video。然后看你要速度还是要画质——开发阶段用 Fast 快速试 prompt，交付时切回 Standard。

用 CLI 的话，操作更直接。文生视频：

seedance generate "夕阳下的湖面，金色光芒铺满水面，镜头缓缓后拉" --wait

图生视频，用一张图作为首帧：

seedance generate "角色缓步走来，风吹动发丝" --first-frame character.png --wait

完整参数控制，指定模型、时长、画幅和分辨率：

seedance generate "产品瓶身置于大理石台面，缓慢环绕拍摄" \
  --model standard --duration 8 --ratio 16:9 --resolution 1080p --wait

如果你是直接调 API，Seedance 2.0 采用异步任务机制——先调创建任务接口拿 task_id，再轮询查询任务状态。生成视频的预览 URL 有效期约 24 小时，记得及时转存。

几个主要应用场景值得单独说：

• 电商信息流视频。抖音电商场景下已经有成熟的复刻链路——拆解竞品视频，仿写口播文案，生成分镜图，再转成 Seedance 2.0 提示词提交生成。音频模式可选 ambient（真实环境音和动作音效）、music（加背景音乐）、voiceover（加人声口播）或 full（全都要）。
• 品牌广告和产品视频。多模态参考能力允许你同时传入产品图、参考视频和参考音频，模型会综合三种信号生成画面。广告团队可以用这个做快速概念验证。
• 影视和动画预览。15 秒多镜头输出配合双声道音频，可以快速产出分镜预览片，降低前期沟通成本。
• 社交媒体系列内容。用 Fast 模型批量生产短视频素材，适合需要高频出片的运营团队。

💡 几个让出片更稳的技巧

• 对白放进双引号里。Seedance 2.0 的原生音频生成默认开启（generate_audio: true）。如果你希望模型生成特定对白，把台词放在英文双引号中能显著优化语音效果。比如：The man said: "Remember, never point at the moon."
• 开发阶段用 Fast 迭代 prompt。Standard 和 Fast 的参数结构完全一致，只是 model 字段不同。你可以用 Fast 快速跑十几个 prompt 变体，找到方向后再切到 Standard 出最终版本。这个工作流比一直用 Standard 硬试省钱得多。
• 时长按秒计费，别默认拉满。Seedance 2.0 采用按秒计费（billing_rule: "per_second"），同一段视频 duration 越长费用越高。测试时用 4 秒的默认值就够了，确认方向再拉长。
• 用 adaptive 画幅缓解首尾帧跳变。Seedance 2.0 的 ratio 参数除了 16:9、9:16 这些固定值，还支持 adaptive——由模型根据输入素材自适应画面比例。做首帧加尾帧的图生视频时，用这个能减少画面跳变。
• 锁 seed 做可控迭代。CLI 支持 --seed 参数用于复现。生成了一版满意的结果后记下 seed，下次用同一个 seed 加微调后的 prompt，可以在保持整体风格的前提下调整细节。
• 复杂编辑拆成多步走。Seedance 2.0 支持视频延长和编辑，但一次只做一件事比一口气改多个元素更可控。先用 generate 出基础片段，再用 extend 续写，最后用 edit 微调。

🔗 可以配合什么使用

• 配合 ComfyUI 做预处理和后处理。用 ComfyUI 的图像处理节点先把素材处理好——去噪、调色、裁切、生成蒙版——再喂给 Seedance 2.0 节点生成视频。生成完的视频也可以接其他节点做后期。
• 配合 n8n 做自动化流水线。社区有 n8n-nodes-seedance2 节点包，可以在 n8n 工作流里自动调用 Seedance 2.0 生成视频。适合需要批量出片或对接电商系统的场景。
• 配合 Seedance Prompt Skill 做脚本生成。有一个专门的 skill 能把小说、文章或故事大纲转换成 Seedance 2.0 的标准剧本、资产生成提示词和时间轴分镜脚本。先用这个 skill 出脚本，再喂给 Seedance 出片，效率比直接写 prompt 高。
• 配合即梦 / 豆包做快速体验。如果你只是想先试一下 Seedance 2.0 的效果，最轻量的方式是打开即梦网页端选择 Seedance 2.0 模型，或者在豆包 App 对话框里选择 2.0 模型。不需要装任何东西就能跑。

🤖 适合哪些 AI 工具

Seedance 2.0 的接入面很宽，不同的使用方式适配不同的工具。

CLI + Skill 路线适合 Claude Code、Cursor、Codex CLI 等支持 Agent Skill 的工具。安装 vaxin/seedance-cli 这个 skill 后，Agent 可以直接通过自然语言调用 Seedance 生成视频。

MCP 路线的兼容面更广，MeiGen AI Design MCP 支持 Claude Code、Cursor、Codex、Windsurf、Roo Code、OpenClaw、Hermes Agent，以及任何遵循 MCP 协议的宿主。

ComfyUI 路线适合已经在节点图里工作的用户，装好自定义节点后可以在 ComfyUI 里直接调用。

另外，字节系应用本身也深度集成了 Seedance 2.0——即梦 AI、豆包、小云雀、剪映等都可以直接使用。如果你只是偶尔出片，用这些应用比装开发环境省事得多。

需要留意的是，Seedance 2.0 是云端模型，不是本地模型。CLI 和 MCP 路线都需要 API Key（火山引擎 Ark 或 muapi.ai 等平台）。如果你想在本地 ComfyUI 里完全离线运行，Seedance 目前不支持——它走的是云端推理。如果你确实需要本地化方案，可以关注 Wan 2.7 这类支持本地部署的模型作为替代。