Back to Details

seedance-video

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Seedance Video Generation

Seedance 视频生成

Generate AI dance and motion videos through AceDataCloud's Seedance (ByteDance) API.
Setup: See authentication for token setup.
通过AceDataCloud的Seedance（字节跳动）API生成AI舞蹈和动态视频。
设置： 请查看身份验证了解令牌设置方法。

Quick Start

快速开始

bash
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"}], "callback_url": "https://api.acedata.cloud/health"}'
Async: See async task polling. Poll via 
POST /seedance/tasks
with 
{"id": "..."}
. This returns a task ID immediately. Poll for the result:
bash
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>"}'
bash
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"}], "callback_url": "https://api.acedata.cloud/health"}'
异步处理： 请查看异步任务轮询。通过
POST /seedance/tasks
接口传入
{"id": "..."}
进行轮询。 该接口会立即返回任务ID，之后可轮询获取结果：
bash
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>"}'

Models

模型

Seedance 2.0 (current generation — multimodal reference)

Seedance 2.0（当前版本 — 多模态参考）

The 2.0 series adds multimodal reference inputs: real-person / character image references, reference audio, and reference video (see the workflows below).
ModelBest ForMax resolution
doubao-seedance-2-0-260128
Highest quality, real-person/character reference, 4k output
4k
doubao-seedance-2-0-fast-260128
Faster 2.0 generation
720p
doubao-seedance-2-0-mini-260615
Lightweight / most cost-effective 2.0
720p
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

Seedance 1.x

ModelTypeBest For
doubao-seedance-1-5-pro-251215
Text+Image-to-Video1.5 flagship, audio support
doubao-seedance-1-0-pro-250528
Text+Image-to-VideoGeneral-purpose, reliable quality
doubao-seedance-1-0-pro-fast-251015
Text+Image-to-VideoFaster Pro generation
doubao-seedance-1-0-lite-t2v-250428
Text-to-Video onlyLightweight text-to-video
doubao-seedance-1-0-lite-i2v-250428
Image-to-Video onlyLightweight image-to-video
模型类型适用场景
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
仅图片转视频轻量级图片转视频

Workflows

工作流

1. Text-to-Video

1. 文本转视频

Pass a text content item in the 
content
array.
json
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
}
在
content
数组中传入文本内容项。
json
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. Image-to-Video

2. 图片转视频

Include an image content item (with an optional 
role
) alongside the text.
json
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
}
Image roles:
  • first_frame
    — image is used as the opening frame
  • last_frame
    — image is used as the closing frame
  • reference_image
    — image is used as a style / subject / real-person reference (Seedance 2.0 keeps the referenced person or character consistent)
Reference media (Seedance 2.0 only):
  • audio_url
    — reference audio for voice timbre / background music (no 
    role
    )
  • video_url
    — reference video for subject, camera movement, motion or overall style (no 
    role
    )
在文本旁添加图片内容项（可选择指定
role
）。
json
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.0支持）：
  • audio_url
    — 参考音频用于音色/背景音乐（无需指定
    role
    ）
  • video_url
    — 参考视频用于主体内容、镜头运动、动作或整体风格（无需指定
    role
    ）

3. First-frame + Last-frame

3. 开场帧 + 结束帧

Provide both a start and end frame image:
json
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"}}
  ]
}
同时提供开场和结束帧图片：
json
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. Real-person / character reference (Seedance 2.0)

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

Seedance 2.0 models (
doubao-seedance-2-0-260128
, 
doubao-seedance-2-0-fast-260128
, 
doubao-seedance-2-0-mini-260615
) can keep a specific person or character consistent across a brand-new scene. Pass one or more photos as 
image_url
items with 
role: "reference_image"
— the model preserves that subject's appearance. Up to 9 reference images are accepted.
json
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
}
Seedance 2.0模型（
doubao-seedance-2-0-260128
、
doubao-seedance-2-0-fast-260128
、
doubao-seedance-2-0-mini-260615
）可在全新场景中保持特定人物或角色的一致性。传入一个或多个
image_url
项并指定
role: "reference_image"
— 模型会保留该主体的外观。最多支持9张参考图片。
json
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. Reference audio / video (Seedance 2.0)

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

2.0 models also accept reference audio (voice timbre, background music) and reference video (subject content, camera movement, motion, overall style). Add 
audio_url
and/or 
video_url
content items. Limits: up to 3 audio and 3 video references per request.
json
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", "audio_url": {"url": "https://example.com/voice.mp3"}},
    {"type": "video_url", "video_url": {"url": "https://example.com/motion.mp4"}}
  ],
  "generate_audio": true
}
2.0模型还支持参考音频（音色、背景音乐）和参考视频（主体内容、镜头运动、动作、整体风格）。添加
audio_url
和/或
video_url
内容项。限制：每个请求最多支持3个音频和3个视频参考。
json
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", "audio_url": {"url": "https://example.com/voice.mp3"}},
    {"type": "video_url", "video_url": {"url": "https://example.com/motion.mp4"}}
  ],
  "generate_audio": true
}

Parameters

参数

ParameterValuesDescription
model
see Models tableModel to use (required)
content
arrayInput items: 
text
, 
image_url
, 
audio_url
(2.0), 
video_url
(2.0) (required)
resolution
"480p"
, 
"720p"
, 
"1080p"
, 
"4k"
Output resolution. 
4k
is 
doubao-seedance-2-0-260128
(standard) only; 
2-0-fast
/ 
2-0-mini
max out at 
720p
(default: 720p for pro/2.0, 480p for lite)
ratio
"16:9"
, 
"4:3"
, 
"1:1"
, 
"3:4"
, 
"9:16"
, 
"21:9"
, 
"adaptive"
Aspect ratio (default: 16:9)
duration
2
– 
15
Duration in seconds (Seedance 2.0 supports 4–15)
frames
29–361 (must satisfy 25+4n)Frame count — mutually exclusive with 
duration
seed
-1 to 4294967295Seed for reproducible results (-1 = random)
generate_audio
true
/ 
false
Generate audio (supported by 
doubao-seedance-1-5-pro-251215
and the 
doubao-seedance-2-0
series; other models ignore it)
camerafixed
true
/ 
false
Fix the camera position during generation
watermark
true
/ 
false
Add a watermark to the generated video
return_last_frame
true
/ 
false
Return the last frame of the generated video
service_tier
"default"
, 
"flex"
Processing tier (default: default)
execution_expires_after
numberTask timeout threshold in seconds
参数可选值描述
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
（默认：专业版/2.0版本为720p，轻量版为480p）
ratio
"16:9"
, 
"4:3"
, 
"1:1"
, 
"3:4"
, 
"9:16"
, 
"21:9"
, 
"adaptive"
宽高比（默认：16:9）
duration
2
– 
15
时长（秒）（Seedance 2.0支持4–15秒）
frames
29–361（需满足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
返回生成视频的最后一帧
service_tier
"default"
, 
"flex"
处理层级（默认：default）
execution_expires_after
数字任务超时阈值（秒）

Inline Parameter Syntax

内联参数语法

You can also embed generation parameters directly in the text prompt using the 
--param value
syntax:
A kitten yawning at the camera. --rs 720p --rt 16:9 --dur 5 --fps 24 --seed 42
Supported inline params: 
--rs
(resolution), 
--rt
(ratio), 
--dur
(duration), 
--frames
, 
--fps
(24 only), 
--seed
, 
--cf
(camera_fixed), 
--wm
(watermark).
你也可以使用
--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
（水印）。

Gotchas

注意事项

  • Model names use the 
    doubao-*
    convention (e.g. 
    doubao-seedance-1-0-pro-250528
    ) — old short names like 
    seedance-1.0
    are not valid
  • The 
    content
    array replaces the old 
    prompt
    + 
    image_url
    fields; always use 
    content
  • Image and text scenarios are mutually exclusive per content item — each item has either 
    text
    or 
    image_url
    , not both
  • first_frame
    and 
    last_frame
    may be combined in one request, but 
    reference_image
    is mutually exclusive with 
    first_frame
    / 
    last_frame
    — do not mix a reference image with first/last frames
  • generate_audio: true
    is supported by 
    doubao-seedance-1-5-pro-251215
    and the 
    doubao-seedance-2-0
    series; other models ignore this field
  • Lite models are split: 
    *-lite-t2v-*
    only accepts text, 
    *-lite-i2v-*
    only accepts image-to-video
  • audio_url
    and 
    video_url
    reference items are used by the Seedance 2.0 series only
  • Resolution options are 
    480p
    , 
    720p
    , 
    1080p
    , and 
    4k
    (
    4k
    is 
    doubao-seedance-2-0-260128
    only; 
    2-0-fast
    / 
    2-0-mini
    max out at 
    720p
    ) — there is no 360p or 540p
  • service_tier
    values are 
    "default"
    and 
    "flex"
    (not "standard"/"premium")
  • Duration range is 2–15 seconds (Seedance 2.0 supports 4–15) — values outside this range will fail
  • Task states use 
    "succeeded"
    (not "completed") — check for this value when polling
MCP: 
pip install mcp-seedance
| Hosted: 
https://seedance.mcp.acedata.cloud/mcp
| See all MCP servers
  • 模型名称采用
    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-t2v-*
    仅接受文本输入，
    *-lite-i2v-*
    仅支持图片转视频
  • audio_url
    和
    video_url
    参考项仅Seedance 2.0系列支持
  • 分辨率选项为
    480p
    、
    720p
    、
    1080p
    和
    4k
    （
    4k
    仅
    doubao-seedance-2-0-260128
    支持；
    2-0-fast
    /
    2-0-mini
    最高支持
    720p
    ）—— 不支持360p或540p
  • service_tier
    可选值为
    "default"
    和
    "flex"
    （不是"standard"/"premium"）
  • 时长范围为2–15秒（Seedance 2.0支持4–15秒）—— 超出该范围的值会导致请求失败
  • 任务状态使用
    "succeeded"
    （不是"completed"）—— 轮询时请检查该状态值
MCP： 
pip install mcp-seedance
| 托管地址：
https://seedance.mcp.acedata.cloud/mcp
| 查看所有MCP服务器