seedance-video

Ace Data Cloud 的 Seedance

通过 AceDataCloud 的 Seedance（ByteDance）API 生成 AI 舞蹈和动作视频。

从 skills.sh 安装并连接

此集成由 Ace Data Cloud 维护；它不是 Seedance 官方发布的条目。仅使用 npx skills add acedatacloud/skills --skill seedance-video --yes 安装此 Skill，或访问 skills.sh 公共页面。选择时请保留 slug seedance-video。

请阅读图文版首次运行指南（简体中文，了解注册、Applications → General application、API 密钥访问与价格查询，以及为编码 Agent 设置环境变量的位置。对于 skills.sh 安装，请使用本指南；任何 ClawHub 专属设置仅适用于 OpenClaw。此处链接的共享参考资料在线提供，因为精简安装不包含同级的 _shared/ 文件夹。

ClawHub / OpenClaw 设置

1. 使用 clawhub install @acedatacloud/seedance 安装官方 Skill。请确认 ClawHub 发布者是 @acedatacloud。
2. 在 AceDataCloud → Applications 登录，打开 General application，检查 Seedance 访问权限、余额和当前价格。复制其 API 密钥，或选择 Manage Keys → Create 创建单独的密钥。复制密钥值时不要包含 Bearer ；platform-... 管理令牌不是服务 API 密钥。
3. 如果启用了 Allowed APIs 限制，请加入 /seedance/videos 和 /seedance/tasks。下方的高级工作流可能会调用其他路由。
4. 在 OpenClaw Gateway 主机上，将 ACEDATACLOUD_API_TOKEN=your_api_key_here 写入 ~/.openclaw/.env，然后重启 Gateway 并开始新会话。如需直接在终端测试，请在该 shell 中运行 export ACEDATACLOUD_API_TOKEN="your_api_key_here"。切勿将密钥放入提示词或提交 .env 文件。
5. 运行下方的 Quick Start。如果此工作流返回任务 ID，请查询同一任务，直到任务完成；不要仅为检查进度而重复提交同一个计费请求。

图文版密钥设置、首次运行和故障排查指南 · 令牌详情

快速开始

curl -X POST https://api.acedata.cloud/seedance/videos \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "doubao-seedance-2-0-260128", "content": [{"type": "text", "text": "a dancer performing contemporary ballet in a misty forest"}], "async": true}'

异步： 请参阅异步任务轮询。通过 POST /seedance/tasks 和 {"id": "..."} 进行轮询。 这会立即返回任务 ID。请轮询以获取结果：

curl -X POST https://api.acedata.cloud/seedance/tasks \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "<task_id from above>"}'

模型

Seedance 2.5（最新旗舰版）

模型	最适合	限制
doubao-seedance-2-5-260628	最长 30 秒，纯音频或多模态参考，视频编辑/延长	480p、720p、1080p；30 张图片 / 10 个视频 / 10 段音频 / 总计 50 项

使用 omni_reference_task_type: "auto"、"edit" 或 "extend"。编辑和延长需要 reference_video 和 ratio: "adaptive"；编辑还需要 duration: -1。可选的 output_format 为 mp4 或 mov。

Seedance 2.0（多模态参考，最高 4k）

2.0 系列新增了多模态参考输入：真人 / 角色图片参考、参考音频和参考视频（参见下方工作流）。

模型	最适合	最高分辨率
doubao-seedance-2-0-260128	最高画质、真人/角色参考、4k 输出	4k
doubao-seedance-2-0-fast-260128	更快的 2.0 生成	720p
doubao-seedance-2-0-mini-260615	轻量 / 性价比最高的 2.0	720p

Seedance 1.x

模型	类型	适用场景
doubao-seedance-1-5-pro-251215	文本+图像生成视频	1.5 旗舰版，支持音频
doubao-seedance-1-0-pro-250528	文本+图像生成视频	通用场景，质量可靠
doubao-seedance-1-0-pro-fast-251015	文本+图像生成视频	更快生成 Pro 版视频
doubao-seedance-1-0-lite-t2v-250428	仅文本生成视频	轻量级文本生成视频
doubao-seedance-1-0-lite-i2v-250428	仅图像生成视频	轻量级图像生成视频

工作流

1. 文本生成视频

在 content 数组中传入一个文本内容项。

POST /seedance/videos
{
  "model": "doubao-seedance-1-0-pro-250528",
  "content": [
    {"type": "text", "text": "a street dancer doing breakdancing moves in an urban setting"}
  ],
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 5
}

2. 图像生成视频

在文本旁添加一个图像内容项（可选提供 role）。

POST /seedance/videos
{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {"type": "text", "text": "the person starts dancing gracefully"},
    {
      "type": "image_url",
      "role": "first_frame",
      "image_url": {"url": "https://example.com/dancer.jpg"}
    }
  ],
  "resolution": "720p",
  "duration": 5
}

图像角色：

• first_frame — 将图像用作起始帧
• last_frame — 将图像用作结束帧
• reference_image — 将图像用作风格／主体／真人参考（Seedance 2.0 会保持参考人物或角色的一致性）

参考媒体（Seedance 2.x）：

• audio_url — 使用 role: "reference_audio"
• video_url — 使用 role: "reference_video"
• 2.5 支持纯音频参考；2.0 则要求音频之外还需提供图像或视频

3. 首帧 + 尾帧

同时提供起始帧和结束帧图像：

POST /seedance/videos
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {"type": "text", "text": "smooth transition between two scenes"},
    {"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/start.jpg"}},
    {"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/end.jpg"}}
  ]
}

4. 真人／角色参考（Seedance 2.0）

Seedance 2.0 模型（doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615）可以在全新场景中保持特定人物或角色的一致性。将一张或多张照片作为 role: "reference_image" 的 image_url 项传入，模型会保留该主体的外观。最多可接受 9 张参考图像。

POST /seedance/videos
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {"type": "text", "text": "the same person walking through a neon-lit night market, cinematic"},
    {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}}
  ],
  "resolution": "1080p",
  "duration": 8
}

5. 参考音频／视频（Seedance 2.0）

2.0 模型还支持参考音频（音色、背景音乐）和参考视频（主体内容、摄像机运动、动作、整体风格）。添加 audio_url 和／或 video_url 内容项。限制：每个请求最多可添加 3 个音频参考和 3 个视频参考。

POST /seedance/videos
{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {"type": "text", "text": "a singer performing on stage, matching the reference voice and motion"},
    {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}},
    {"type": "audio_url", "role": "reference_audio", "audio_url": {"url": "https://example.com/voice.mp3"}},
    {"type": "video_url", "role": "reference_video", "video_url": {"url": "https://example.com/motion.mp4"}}
  ],
  "generate_audio": true
}

参数

参数	值	描述
model	参见模型表	要使用的模型（必填）
content	数组	输入项：text、image_url、audio_url（2.0）、video_url（2.0）（必填）
resolution	"480p"、"720p"、"1080p"、"4k"	输出分辨率。4k 仅适用于 doubao-seedance-2-0-260128（标准版）；2-0-fast／2-0-mini 最高支持 720p（默认：pro／2.0 为 720p，lite 为 480p）
ratio	"16:9"、"4:3"、"1:1"、"3:4"、"9:16"、"21:9"、"adaptive"	宽高比（默认：16:9）
duration	2 – 30，或 -1	1.0：2–12（不支持自动）；1.5 Pro：4–12／-1；2.0：4–15／-1；2.5：4–30／-1
frames	29–289（必须满足 25+4n）	帧数 — 不能与 duration 同时使用
seed	-1 至 4294967295	用于获得可复现结果的种子（-1 = 随机）
generate_audio	true／false	生成音频（doubao-seedance-1-5-pro-251215 和 doubao-seedance-2-0 系列支持此参数；其他模型会忽略）
camerafixed	true／false	生成期间固定摄像机位置
watermark	true／false	为生成的视频添加水印
return_last_frame	true／false	返回生成视频的最后一帧
omni_reference_task_type	auto、edit、extend	Seedance 2.5 任务类型
output_format	mp4、mov	Seedance 2.5 输出格式
tools	object[]	Seedance 2.5 网络搜索工具，例如 [{"type":"web_search"}]
priority	0–9	Seedance 2.5 队列优先级
safety_identifier	字符串	稳定的匿名最终用户 ID（最多 64 个字符；请勿发送个人身份信息）
execution_expires_after	数字	任务超时阈值，单位为秒

内联参数语法

你也可以使用 --param value 语法，直接在文本提示词中嵌入生成参数：

A kitten yawning at the camera. --rs 720p --rt 16:9 --dur 5 --fps 24 --seed 42

支持的内联参数：--rs（分辨率）、--rt（比例）、--dur（时长）、--frames、--fps（仅支持 24）、--seed、--cf（camera_fixed）、--wm（水印）。

注意事项

• 模型名称采用 doubao-* 约定（例如 doubao-seedance-1-0-pro-250528）——旧的短名称（如 seedance-1.0）无效
• content 数组取代了旧的 prompt + image_url 字段；请始终使用 content
• 每个内容项中的图像和文本场景互斥——每项只能包含 text 或 image_url，不能同时包含两者
• first_frame 和 last_frame 可以在同一请求中组合使用，但 reference_image 与 first_frame / last_frame 互斥——请勿将参考图像与首帧/末帧混用
• generate_audio: true 受 doubao-seedance-1-5-pro-251215 和 doubao-seedance-2-0 系列支持；其他模型会忽略此字段
• Lite 模型分为两类：*-lite-t2v-* 仅接受文本，*-lite-i2v-* 仅接受图生视频
• Seedance 2.0 和 2.5 支持 audio_url 和 video_url 引用项；2.5 还支持纯音频引用
• 分辨率选项为 480p、720p、1080p 和 4k（4k 仅适用于 doubao-seedance-2-0-260128；2-0-fast / 2-0-mini 最高支持 720p）——不支持 360p 或 540p
• 时长因模型而异：1.0 支持 2–12；1.5 Pro 支持 4–12/-1；2.0 支持 4–15/-1；2.5 支持 4–30/-1
• 任务状态使用 "succeeded"（而非 "completed"）——轮询时请检查此值

MCP： pip install mcp-seedance | 托管服务：https://seedance.mcp.acedata.cloud/mcp | 查看所有 MCP 服务