LoopToken
视频生成

Seedance 系列

Seedance 文生视频、首帧与首尾帧视频生成接口

Seedance 系列支持纯文本生成视频、首帧生成视频、首尾帧过渡、参考图驱动，以及可选的自动音频生成。接口采用异步任务模式：先提交生成任务，再轮询平台任务状态。

适用模型

同一代 Seedance 有多条通道，靠模型名后缀区分：-ext 企业版、-exp 实验版、-exl 镜像版、-exr 直通版，-max、-ak、-hig、-mag 长片版。请求体形状全都一样，差别只在参数范围、计费方式和出片速度。

模型resolutiondurationratio计费
doubao-seedance-2-5-cloud480p/720p/1080p4-30，可 -1七选一，含 adaptive按秒
seedance-2-5-exp480p/720p必填 15-3016:9/9:16按次
seedance-2-5-exl480p/720p必填 15-3016:9/9:16按次
seedance-2-5-exr480p/720p4-30六选一，无自适应按秒
seedance-2-5-max480p/720p/1080p4-30六选一，无自适应按秒
seedance-2-5-ak480p/720p4-30六选一，无自适应按秒
seedance-2-5-hig480p/720p4-30七选一，含 adaptive按秒
seedance-2-0-exp只有 720p4-15七选一，含 adaptive按秒
seedance-2-0-exl480p/720p4-15六选一，无自适应按次
seedance-2-0-exr480p/720p5-15六选一，无自适应按秒
seedance-2-0-ak480p/720p4-15六选一，无自适应按秒
seedance-2-0-hig480p/720p4-15七选一，含 adaptive按秒
seedance-2-0-mag480p/720p4-15七选一，含 adaptive按秒
seedance-2-0-ext480p/720p/1080p/4k4-15，可 -1七选一，含 adaptive按秒
seedance-fast-2-0-ext480p/720p/1080p/4k4-15，可 -1七选一，含 adaptive按秒
doubao-seedance-2-0-260128480p/720p/1080p/4k4-15，可 -1七选一，含 adaptive按秒
doubao-seedance-2-0-fast-260128480p/720p4-15，可 -1七选一，含 adaptive按秒
doubao-seedance-2-0-mini-260615480p/720p4-15，可 -1七选一，含 adaptive按秒

按次计费的模型，同一分辨率下时长不影响价格——seedance-2-5-exl 写 15 秒和写 30 秒一个价。

四条容易踩的硬约束，写请求前先确认：seedance-2-5-exl、seedance-2-5-ak、两个 -hig 和 seedance-2-0-mag 必须带至少一张参考图，seedance-2-0-exl 不接受 adaptive（会按 16:9 出片），seedance-2-0-exr、seedance-2-5-exr 和六个长片版 不支持首帧和尾帧（-ak、-hig 与 -mag 连参考视频也不支持），seedance-2-5-max 没有 4k 档、-ak、-hig 与 -mag 只有 480p 和 720p 两档。各模型的完整边界见下方对应章节。

实际可用模型与价格以模型列表为准。

调用流程

  1. 调用 POST /v1/videos/generations 提交任务，成功时返回 HTTP 202 和平台任务 ID。
  2. 每隔 5-10 秒调用 GET /v1/tasks/{task_id} 查询任务。
  3. status 为 pending 或 running 时继续轮询。
  4. status 为 succeeded 时读取 video_url；为 failed 时读取 error。

提交任务

POST /v1/videos/generations

请求头

Header必填说明
Authorization是Bearer <your-api-key>
Content-Type是固定为 application/json

顶层请求参数

参数类型必填默认值说明
modelstring是-本页适用模型之一
contentarray是-提示词与图片素材数组，至少包含一个 text 对象
resolutionstring否720p取值逐模型不同，见适用模型
ratiostring否adaptive16:9、4:3、1:1、3:4、9:16、21:9 或 adaptive；实验版与镜像版的可选范围更窄，见适用模型
durationinteger否-1（2.5）/5（其余）范围逐模型不同，实验版与镜像版必填或不接受 -1，见适用模型
generate_audioboolean否true是否生成与画面同步的人声、音效和背景音乐
omni_reference_task_typestring否auto2.5：auto、edit、extend；企业版：auto、reference、edit、extend
output_formatstring否mp42.5 与企业版：mp4 或适合后期处理的 mov
return_last_frameboolean否false是否在任务结果中返回生成视频的最后一帧
watermarkboolean否false是否在视频右下角添加“AI 生成”水印
priorityinteger否0任务排队优先级，范围 0-9，数值越大优先级越高
execution_expires_afterinteger否172800任务过期阈值，单位秒，范围 3600-259200
callback_urlstring否-任务终态回调地址，必须为可公网访问的 HTTPS 地址

Seedance 的推荐写法是顶层 content、ratio、duration。不要把 Wan 系列的 input、parameters 请求体用于本页模型。

文本对象

content 中至少包含一个文本对象，用于描述主体、动作、镜头、场景、光影、风格和音效。

参数类型必填说明
typestring是固定为 text
textstring是视频提示词。使用多张参考图时，应明确描述每张图的用途
{
  "type": "text",
  "text": "出现一只小猫，镜头缓慢向前推进，小猫抬头看向镜头"
}

图片对象

图片对象可作为首帧、尾帧或普通参考图。图片地址支持公网 HTTP/HTTPS URL，也支持 data:{MIME};base64,{data} 格式。

参数类型必填说明
typestring是固定为 image_url
image_urlobject是图片资源对象
image_url.urlstring是公网图片 URL 或 Base64 Data URL
rolestring是first_frame、last_frame 或 reference_image

role 说明：

role用途数量限制
first_frame指定视频第一帧最多 1 张
last_frame指定视频最后一帧，生成首尾平滑过渡最多 1 张；应与 first_frame 同时使用
reference_image参考人物、物体、场景或画面风格全部图片合计最多 9 张

参考视频对象

参数类型必填说明
typestring是固定为 video_url
video_url.urlstring是公网可访问的 MP4 视频 URL
rolestring是固定为 reference_video

2.5 最多传入 10 个参考视频且总时长不超过 30 秒；2.0 与企业版最多 3 个。

参考音频对象

参数类型必填说明
typestring是固定为 audio_url
audio_url.urlstring是公网可访问的 MP3 音频 URL
rolestring是固定为 reference_audio

2.5 最多传入 10 个参考音频且总时长不超过 30 秒，并支持纯音频参考；2.0 最多 3 个，且必须同时包含至少一张图片或一个视频。传入参考音频时，可通过 generate_audio 决定是否同时生成额外配音或音效。

Seedance 2.5 特殊约束

  • 首帧、首尾帧、视频编辑和视频延长任务必须设置 ratio: "adaptive"。
  • 编辑任务设置 omni_reference_task_type: "edit"、duration: -1，并至少提供一个 4-30 秒参考视频。
  • 延长任务设置 omni_reference_task_type: "extend"，并至少提供一个参考视频。
  • 单次最多 30 张图片、10 个视频、10 个音频；图片、视频、音频合计最多 50 个素材。
  • 2.5 不支持 4k。

2.5 文生视频

{
  "model": "doubao-seedance-2-5-cloud",
  "content": [
    {"type": "text", "text": "海边日出，镜头缓慢横移，电影级光影和自然海浪声"}
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 20,
  "generate_audio": true
}

2.5 视频编辑

{
  "model": "doubao-seedance-2-5-cloud",
  "content": [
    {"type": "text", "text": "将 @Video 1 的天空替换为晚霞，保留人物动作和原始对白"},
    {
      "type": "video_url",
      "role": "reference_video",
      "video_url": {"url": "https://example.com/source.mov"}
    }
  ],
  "omni_reference_task_type": "edit",
  "ratio": "adaptive",
  "duration": -1,
  "output_format": "mov"
}

Seedance 2.5 实验版

seedance-2-5-exp 走独立通道，请求体形状与本页其余 Seedance 模型一致，区别在参数范围和计费方式：

项seedance-2-5-expdoubao-seedance-2-5-cloud
resolution480p、720p480p、720p、1080p
duration必填，15-30 秒整数4-30，可传 -1 自动
ratio16:9、9:16七种取值，含 adaptive
计费按次，与时长、素材数量无关按秒

三条硬约束，越界直接返回 400：

  • duration 必填，只收 15 到 30 的整数，不支持 -1。
  • ratio 只有横屏 16:9 和竖屏 9:16。首帧任务也用这两个值，不要传 adaptive。
  • resolution 只有 480p 和 720p，不传按 720p 计价出片。

素材上限与 2.5 相同：最多 30 张图片、10 个视频、10 个音频，首帧和尾帧各最多 1 张。generate_audio、output_format 等 2.5 参数按 2.5 的写法传入。

拍 30 秒和拍 15 秒是一个价，同一档分辨率下参考素材加多少也不加价。

实验版出片明显慢于其他 Seedance 模型，15 秒的片实测约 17 分钟。轮询期间任务会长时间停在 running，属正常，不要重复提交。

实验版文生视频

{
  "model": "seedance-2-5-exp",
  "content": [
    {"type": "text", "text": "城市清晨的街道逐渐苏醒，行人穿过斑马线，镜头缓慢平移，写实光影"}
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 20
}

实验版首尾帧

{
  "model": "seedance-2-5-exp",
  "content": [
    {"type": "text", "text": "从清晨过渡到黄昏，云层快速流动"},
    {"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/dawn.jpg"}},
    {"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/dusk.jpg"}}
  ],
  "resolution": "480p",
  "ratio": "9:16",
  "duration": 15
}

Seedance 2.0 实验版

seedance-2-0-exp 和 2.5 实验版走同一条独立通道，请求体形状不变，差别在能力边界与计费方式：

项seedance-2-0-expseedance-2-5-exp
resolution只有 720p480p、720p
duration4-15 秒，默认 5必填，15-30
ratioadaptive、21:9、16:9、4:3、1:1、3:4、9:16只有 16:9、9:16
计费按秒按次

支持参考图、参考视频、参考音频，素材写法与本页其余 Seedance 模型一致。

resolution 传 720p 以外的值直接返回 400。这个模型的上游只有 720p 一档， 不像企业版那样有 1080p、4k 可选。

2.0 实验版文生视频

{
  "model": "seedance-2-0-exp",
  "content": [
    {"type": "text", "text": "雨后的老街，积水倒映着霓虹，镜头缓慢推进，写实电影感"}
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 8
}

2.0 实验版参考图生视频

{
  "model": "seedance-2-0-exp",
  "content": [
    {"type": "text", "text": "@图1 中的人物转身走向远处，镜头跟随"},
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {"url": "https://example.com/character.jpg"}
    }
  ],
  "resolution": "720p",
  "ratio": "9:16",
  "duration": 5
}

Seedance 2.0 镜像版

seedance-2-0-exl 是 Seedance 2.0 的另一条通道，请求体形状与本页其余 Seedance 模型一致，差别在能力边界与计费方式：

项seedance-2-0-exlseedance-2-0-exp
resolution480p、720p只有 720p
duration4-15 秒，默认 54-15 秒，默认 5
ratio21:9、16:9、4:3、1:1、3:4、9:16同左，另支持 adaptive
素材上限9 张图 / 3 个视频 / 3 个音频同左
计费按次，只看 resolution按秒
轮询进度回报真实 progress无，恒为 0 直到终态

按次计费意味着 5 秒和 15 秒一个价。duration 不传时按 5 秒出片，仍收整次的钱——要长片就显式写 "duration": 15。

三点与本页其他模型不同，请求前先对一下：

  • ratio 可以传 adaptive，但这条通道没有自适应比例，最终按 16:9 出片。要竖屏就显式传 9:16。
  • 参考素材在提交阶段同步校验：URL 取不到、或者返回的不是媒体文件，直接返回 400，任务不建立、不计费。不像其他模型那样先排队再异步失败。
  • 出片原生带音轨，没有 generate_audio 开关。需要无声成片请自行去除音轨。

实际画幅按短边对齐档位：480p + 16:9 出 864×496，720p + 9:16 出 720×1280。5-10 秒的片实测 2-3 分钟出片。

镜像版文生视频

{
  "model": "seedance-2-0-exl",
  "content": [
    {"type": "text", "text": "雨后的城市街道，霓虹倒映在积水中，镜头横移，写实电影感"}
  ],
  "resolution": "720p",
  "ratio": "9:16",
  "duration": 15
}

镜像版参考图生视频

{
  "model": "seedance-2-0-exl",
  "content": [
    {"type": "text", "text": "@图1 中的猫在草地上奔跑，镜头跟随"},
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {"url": "https://example.com/cat.jpg"}
    }
  ],
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 10
}

Seedance 2.5 镜像版

seedance-2-5-exl 与 2.0 镜像版走同一条通道，请求体形状不变，能力边界和 2.5 实验版更接近：

项seedance-2-5-exlseedance-2-5-exp
resolution480p、720p同左
duration必填，15-30 秒同左
ratio16:9、9:16同左
参考图必填，至少一张可选
素材上限30 张图 / 10 个视频 / 10 个音频9 张图 / 3 个视频 / 3 个音频
计费按次，只看 resolution按次
出片耗时15-30 秒的片实测 5-7 分钟15 秒的片实测约 17 分钟
轮询进度回报真实 progress无，恒为 0 直到终态

这个模型不做纯文生视频。content 里只有文本、没有任何 image_url 时直接返回 400。

按次计费意味着 15 秒和 30 秒一个价，duration 又是必填的——要长片就直接写 "duration": 30，不会多花钱。

素材不在提交阶段校验：参考图 URL 取不到时任务照样建立并计费，几分钟后才异步失败。上传前请自行确认 URL 公网可达且返回的是图片。

2.5 镜像版参考图生视频

{
  "model": "seedance-2-5-exl",
  "content": [
    {"type": "text", "text": "@图1 中的山谷云海翻涌，镜头缓慢升起，写实电影感"},
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {"url": "https://example.com/valley.jpg"}
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 30
}

2.5 镜像版首尾帧

{
  "model": "seedance-2-5-exl",
  "content": [
    {"type": "text", "text": "镜头从清晨过渡到黄昏，光线缓慢变化"},
    {
      "type": "image_url",
      "role": "first_frame",
      "image_url": {"url": "https://example.com/morning.jpg"}
    },
    {
      "type": "image_url",
      "role": "last_frame",
      "image_url": {"url": "https://example.com/dusk.jpg"}
    }
  ],
  "resolution": "480p",
  "ratio": "9:16",
  "duration": 15
}

Seedance 2.0 直通版

seedance-2-0-exr 是 Seedance 2.0 的第三条通道，请求体形状与本页其余 Seedance 模型一致，差别在计费方式和素材能力：

项seedance-2-0-exrseedance-2-0-exl
resolution480p、720p同左
duration5-15 秒，默认 54-15 秒，默认 5
ratio21:9、16:9、4:3、1:1、3:4、9:16同左
首帧 / 尾帧不支持支持
素材上限9 图 / 3 视频 / 3 音频，合计不超过 12 条9 图 / 3 视频 / 3 音频
计费按秒按次
轮询进度回报真实 progress同左

按秒计费意味着 15 秒的片是 5 秒的三倍价。duration 不传时按 5 秒出片，需要长片再显式写。

三点与本页其他模型不同，请求前先对一下：

  • content 里的图片只能用 role: reference_image。这条通道没有首尾帧模式，带 first_frame 或 last_frame 直接返回 400，任务不建立、不计费。
  • duration 最短 5 秒，比其他 2.0 模型高一秒；写 4 会被拒。
  • ratio 可以传 adaptive，但这条通道没有自适应比例，最终按横屏默认比例出片。要竖屏就显式传 9:16 或 3:4。

5 秒的片实测 5-8 分钟出片，带参考图的更慢。

直通版文生视频

{
  "model": "seedance-2-0-exr",
  "content": [
    {"type": "text", "text": "雨后的城市街道，霓虹倒映在积水中，镜头横移，写实电影感"}
  ],
  "resolution": "720p",
  "ratio": "9:16",
  "duration": 15
}

直通版参考图生视频

{
  "model": "seedance-2-0-exr",
  "content": [
    {"type": "text", "text": "@图1 中的猫在草地上奔跑，镜头跟随"},
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {"url": "https://example.com/cat.jpg"}
    }
  ],
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 10
}

Seedance 2.5 直通版

seedance-2-5-exr 是 Seedance 2.5 里素材容量最大的一条通道：最多 30 张参考图，4-30 秒按秒计费，480p 与 720p 两档都能出。请求体形状与本页其余 Seedance 模型一致。

项seedance-2-5-exrseedance-2-5-exl
resolution480p、720p同左
duration4-30 秒，默认 5必填 15-30 秒
ratio21:9、16:9、4:3、1:1、3:4、9:1616:9、9:16
参考图可选，纯文生可用必填至少一张
首帧 / 尾帧不支持支持
素材上限30 图 / 10 视频 / 10 音频同左
计费按秒按次
轮询进度回报真实 progress同左

按秒计费意味着 30 秒的片是 5 秒的六倍价。duration 不传时按 5 秒出片，要长片必须显式写。

三点与其他 2.5 通道不同，请求前先对一下：

  • content 里的图片只能用 role: reference_image。这条通道没有首尾帧模式，带 first_frame 或 last_frame 直接返回 400，任务不建立、不计费。
  • ratio 可以传 adaptive，但这条通道没有自适应比例，最终按横屏默认比例出片。要竖屏就显式传 9:16 或 3:4。
  • 与 seedance-2-5-exl 相反，这条通道不要求带参考图；比例也比它宽，横屏竖屏之外还能出 1:1、21:9。

出片慢是这条通道的常态：4 秒的片实测 15 分钟，长片和带参考素材的更久，排队时 progress 会长时间停在个位数。轮询超过 55 分钟平台会判 timeout 并退款。

2.5 直通版文生视频

{
  "model": "seedance-2-5-exr",
  "content": [
    {"type": "text", "text": "雪后的山间小镇，清晨薄雾，镜头缓慢推进，写实电影感"}
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 10
}

2.5 直通版多素材参考

{
  "model": "seedance-2-5-exr",
  "content": [
    {"type": "text", "text": "@图1 里的女孩走进 @图2 的咖啡馆，镜头跟随，暖色调"},
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {"url": "https://example.com/girl.jpg"}
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {"url": "https://example.com/cafe.jpg"}
    }
  ],
  "resolution": "480p",
  "ratio": "9:16",
  "duration": 20
}

Seedance 2.5 长片版

seedance-2-5-max 是 Seedance 2.5 里按秒计费、时长跨度最大的通道，4 秒短片到 30 秒长片都能出。分辨率有 480p、720p、1080p 三档，请求体形状与本页其余 Seedance 模型一致。

项seedance-2-5-maxseedance-2-5-exl
resolution480p、720p、1080p480p、720p
duration4-30 秒，默认 5必填 15-30 秒
ratio21:9、16:9、4:3、1:1、3:4、9:1616:9、9:16
参考图可选必填至少一张
首帧 / 尾帧不支持支持
计费按秒按次
轮询进度回报真实 progress同左

按秒计费意味着 30 秒的片是 5 秒的六倍价。duration 不传时按 5 秒出片，要长片必须显式写。

三点与其他 2.5 通道不同，请求前先对一下：

  • resolution 接受 480p、720p、1080p，不传按 720p 出片。写 4k 会返回 400，任务不建立、不计费。
  • content 里的图片只能用 role: reference_image。带 first_frame 或 last_frame 直接返回 400。
  • 与 seedance-2-5-exl 相反，这条通道不要求带参考图，纯文生可用；比例范围也宽一档，横屏竖屏之外还能出 1:1、21:9。

带参考视频时按加价档计费，每秒比纯文生贵一档，与 doubao-seedance-2-5-cloud 同口径。

20 秒的片实测 4-6 分钟出片，带参考图的更慢。

长片版文生视频

{
  "model": "seedance-2-5-max",
  "content": [
    {"type": "text", "text": "海边日落，一只猫沿着沙滩缓慢行走，长镜头跟随，写实电影感"}
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 20,
  "generate_audio": true
}

长片版参考图生视频

{
  "model": "seedance-2-5-max",
  "content": [
    {"type": "text", "text": "让图中的产品在干净的摄影棚里旋转展示，真实光影，高级质感"},
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {"url": "https://example.com/product.png"}
    }
  ],
  "resolution": "720p",
  "ratio": "9:16",
  "duration": 30
}

长片版 -ak 通道

seedance-2-5-ak 和 seedance-2-0-ak 是同一条产能上的两代模型，请求体形状、比例枚举、按秒计费口径完全一样，两条硬约束也一样：

  • 只出 480p 和 720p。 写 1080p 或 4k 返回 400。
  • 不支持参考视频。 content 里带 type: video_url 返回 400，首帧和尾帧同样不支持。

两代之间差两条，都在 2.5 这边更严：

seedance-2-5-akseedance-2-0-ak
duration4-304-15
参考图必须带至少一张 role: reference_image可以不带，支持纯文生视频

按 2.5 的写法给 2.0 发 20 秒会返回 400；反过来给 2.5 发纯提示词也返回 400，任务不建立、不计费。

seedance-2-5-ak 与 seedance-2-5-max 的 480p/720p 两档同价，但各走各的产能。seedance-2-5-max 排队时可以直接把 model 换成 seedance-2-5-ak 重发，前提是原请求没写 1080p、也没带参考视频。

{
  "model": "seedance-2-0-ak",
  "content": [
    {"type": "text", "text": "让画面里的人物沿着海边缓慢行走，长镜头跟随，写实电影感"},
    {
      "type": "image_url",
      "image_url": {"url": "https://example.com/reference.png"},
      "role": "reference_image"
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 10,
  "generate_audio": true
}

长片版 -hig 与 -mag 通道

seedance-2-5-hig、seedance-2-0-hig 和 seedance-2-0-mag 分属两条产能，-mag 这条只有 2.0 一代。三个模型的边界完全一样，与 -ak 差两处：

-ak-hig / -mag
参考图只有 2.5 必须带一律必须带至少一张 role: reference_image
ratio: adaptive返回 400支持

其余照搬 -ak：只出 480p 和 720p，写 1080p 或 4k 返回 400；不支持参考视频、首帧和尾帧；duration 2.5 是 4-30、2.0 是 4-15，按秒计费。

所以给 seedance-2-0-hig 或 seedance-2-0-mag 发纯提示词会返回 400——seedance-2-0-ak 收这种请求，这两个不收。任务不建立、不计费，补一张参考图重发即可。

参考图 URL 必须是能匿名直接下载的直链。上游拉图时不带 User-Agent、也不跟随跳转：对 UA 有要求的图床（维基共享资源）返 403，带 302 的随机图链接（picsum.photos 这类）也拉不到。两种都在提交之后才失败，任务以 upstream_error 收尾、预扣全额退回。用自己的 OSS 或对象存储直链最稳。

同代的几条长片通道价格一致，model 换个后缀就能换产能。seedance-2-5-max 或两个 -ak 排队时，可以把请求原样改投 -hig（2.0 还可以改投 -mag），前提是没写 1080p、没带参考视频，且 2.0 的请求带了参考图。

{
  "model": "seedance-2-5-hig",
  "content": [
    {"type": "text", "text": "镜头缓慢环绕产品一周，干净背景，真实光影，高级质感"},
    {
      "type": "image_url",
      "image_url": {"url": "https://example.com/product.png"},
      "role": "reference_image"
    }
  ],
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": 20,
  "generate_audio": true
}

Seedance 2.0 企业版

seedance-2-0-ext 与 seedance-fast-2-0-ext 是 Seedance 2.0 的企业版通道，请求体形状与本页其余 Seedance 模型完全一致，区别只在能力边界与价格：

项seedance-2-0-extseedance-fast-2-0-ext
定位专业级质量优先速度优先
resolution480p、720p、1080p、4k480p、720p、1080p、4k
duration4-15 秒4-15 秒
ratio21:9、16:9、4:3、1:1、3:4、9:16、adaptive同左
omni_reference_task_typeauto、reference、edit、extend同左
output_formatmp4、mov同左
素材上限最多 9 张图片、3 个参考视频、3 个参考音频同左

企业版原生音画同出：支持多语种、口音与方言演绎，并可高精度还原物品细节、材质、音色、视效风格与运镜，角色特征在多镜头之间保持稳定。需要无声视频时显式设置 generate_audio: false。

企业版的 duration 上限是 15 秒，比 2.5 的 30 秒短；resolution 则比 2.5 多出 4k 一档。跨模型迁移请求体时注意这两处差异。

企业版文生视频

{
  "model": "seedance-2-0-ext",
  "content": [
    {"type": "text", "text": "写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠"}
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "watermark": false
}

企业版参考图生视频

{
  "model": "seedance-fast-2-0-ext",
  "content": [
    {"type": "text", "text": "@图1 中的人物在雨中缓步前行，镜头跟随，霓虹倒影，电影级光影"},
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {"url": "https://example.com/character.jpg"}
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 8
}

企业版 cURL 示例

curl https://api.vibelab.me/v1/videos/generations \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0-ext",
    "content": [
      {"type": "text", "text": "写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近"}
    ],
    "ratio": "16:9",
    "resolution": "720p",
    "duration": 5,
    "watermark": false
  }'

请求示例

纯文生视频

{
  "model": "doubao-seedance-2-0-260128",
  "ratio": "16:9",
  "content": [
    {
      "type": "text",
      "text": "海边日落，海浪拍打礁石，镜头缓慢横移，电影级光影"
    }
  ],
  "duration": 5
}

首帧生视频

{
  "model": "doubao-seedance-2-0-260128",
  "ratio": "16:9",
  "content": [
    {
      "type": "text",
      "text": "小猫缓缓睁开眼睛，站起来伸懒腰，镜头轻微向前推进"
    },
    {
      "type": "image_url",
      "role": "first_frame",
      "image_url": {
        "url": "https://example.com/cat-first-frame.jpg"
      }
    }
  ],
  "duration": 4
}

首尾帧生成

{
  "model": "doubao-seedance-2-0-260128",
  "ratio": "16:9",
  "content": [
    {
      "text": "出现一个小猫",
      "type": "text"
    },
    {
      "role": "first_frame",
      "type": "image_url",
      "image_url": {
        "url": "https://canvai.oss-cn-shanghai.aliyuncs.com/upload/41fad299528f4e8f9c1bdd8d8332d1e7.jpeg"
      }
    },
    {
      "role": "last_frame",
      "type": "image_url",
      "image_url": {
        "url": "https://canvai.oss-cn-shanghai.aliyuncs.com/upload/f546e0cd307c471d93dc553d28e21246.png"
      }
    }
  ],
  "duration": 4
}

cURL 完整示例

curl https://api.vibelab.me/v1/videos/generations \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "ratio": "16:9",
    "content": [
      {"type": "text", "text": "出现一个小猫"},
      {
        "type": "image_url",
        "role": "first_frame",
        "image_url": {"url": "https://example.com/first.jpg"}
      },
      {
        "type": "image_url",
        "role": "last_frame",
        "image_url": {"url": "https://example.com/last.png"}
      }
    ],
    "duration": 4
  }'

提交响应

提交成功返回 HTTP 202：

字段类型说明
task_idstring平台任务 ID，格式为 vt_ + UUID
modelstring请求使用的模型
statusstring提交成功时为 pending
created_atinteger创建时间，Unix 秒
durationinteger请求的视频时长
resolutionstring计费分辨率档位
{
  "task_id": "vt_019c8d85-75fd-7a31-b33f-8cf90e83a62b",
  "model": "doubao-seedance-2-0-260128",
  "status": "pending",
  "progress": 0,
  "created_at": 1783819200,
  "duration": 4,
  "resolution": "720p"
}

查询任务

GET /v1/tasks/{task_id}

路径参数

参数类型说明
task_idstring提交任务返回的 vt_... ID

任务状态

status说明
pending排队中
running正在生成
succeeded生成成功
failed生成失败

任务对象里的 progress 是 0-100 的进度百分比，终态一律 100。本页只有 seedance-2-0-exl、seedance-2-5-exl、seedance-2-0-exr、seedance-2-5-exr 与六个长片版会回报真实进度，其余模型在生成期间恒为 0——判断任务是否结束请看 status。

成功响应字段

字段类型说明
task_idstring平台任务 ID
modelstring模型名称
statusstringsucceeded
progressinteger100
created_atinteger创建时间，Unix 秒
completed_atinteger完成时间，Unix 秒
video_urlstring视频下载 URL，请及时下载转存
expires_atinteger下载 URL 过期时间，Unix 秒
durationnumber实际视频时长，单位秒
resolutionstring720p 或 1080p
ratiostring实际视频比例，例如 16:9
usageobject模型返回的用量明细
credits_chargednumber实际扣费金额
{
  "task_id": "vt_019c8d85-75fd-7a31-b33f-8cf90e83a62b",
  "model": "doubao-seedance-2-0-260128",
  "status": "succeeded",
  "progress": 100,
  "created_at": 1783819200,
  "completed_at": 1783819268,
  "video_url": "https://example.com/generated/video.mp4",
  "expires_at": 1784078468,
  "duration": 4,
  "resolution": "720p",
  "ratio": "16:9",
  "usage": {
    "duration": 4,
    "video_count": 1,
    "SR": 720,
    "ratio": "16:9",
    "output_video_duration": 4
  },
  "credits_charged": 24
}

失败响应字段

字段类型说明
statusstringfailed
error.codestringtimeout 或 upstream_error
error.messagestring失败原因
completed_atinteger任务失败时间
{
  "task_id": "vt_019c8d85-75fd-7a31-b33f-8cf90e83a62b",
  "model": "doubao-seedance-2-0-260128",
  "status": "failed",
  "progress": 100,
  "error": {
    "code": "upstream_error",
    "message": "video generation failed"
  },
  "completed_at": 1783819268
}

素材限制与建议

  • 2.5 最多 30 张图片、10 个参考视频、10 个参考音频；2.0 与企业版最多 9/3/3。seedance-2-0-exr 在 9/3/3 之外还有一条合计不超过 12 条素材的上限。
  • 公网 URL 必须允许模型服务直接下载，不能要求登录、Cookie 或临时请求头。
  • Base64 只适用于图片，格式为 data:image/png;base64,... 或 data:image/jpeg;base64,...。
  • 首尾帧的主体、构图和宽高比应尽量接近，否则更容易出现跳变、形变或过渡失败。
  • duration 的取值范围逐模型不同，见适用模型。-1（由模型自动选择）只有 doubao- 开头的模型和企业版接受，实验版与镜像版会直接返回 400。
  • doubao- 开头的模型与企业版默认生成有声视频，需要无声时显式设置 generate_audio: false；两个镜像版没有这个开关，出片一律带音轨。
  • ratio: adaptive 时，文生视频会根据提示词选择比例，首帧/首尾帧场景会按首帧选择最接近的比例。镜像版与直通版都没有自适应：seedance-2-0-exl、seedance-2-0-exr 与 seedance-2-5-exr 会退化成横屏默认比例，seedance-2-5-exl、seedance-2-5-max 和两个 -ak 直接返回 400；两个 -hig 与 seedance-2-0-mag 支持自适应。六个长片版不传 ratio 一律按 16:9 出片，要自适应就显式写 adaptive。
  • 生成结果 URL 有时效，任务成功后应立即下载到自己的存储。

错误

HTTP 状态码code说明
400invalid_request_error缺少模型、content 为空、参数类型错误、素材数量超限或回调地址不合法
402insufficient_credits余额不足
404model_not_found模型不存在
404task_not_found任务不存在或无权访问
502upstream_error模型任务提交失败
503no_available_channel模型暂时不可用

统一错误体格式见错误码。计费采用“实际时长 × 分辨率档位单价”，价格见模型列表。

Kling v3

kling-v3 视频生成字段

Wan 视频系列

LoopToken Wan 视频模型的完整异步生成 API 接入说明

本页内容

适用模型调用流程提交任务请求头顶层请求参数文本对象图片对象参考视频对象参考音频对象Seedance 2.5 特殊约束2.5 文生视频2.5 视频编辑Seedance 2.5 实验版实验版文生视频实验版首尾帧Seedance 2.0 实验版2.0 实验版文生视频2.0 实验版参考图生视频Seedance 2.0 镜像版镜像版文生视频镜像版参考图生视频Seedance 2.5 镜像版2.5 镜像版参考图生视频2.5 镜像版首尾帧Seedance 2.0 直通版直通版文生视频直通版参考图生视频Seedance 2.5 直通版2.5 直通版文生视频2.5 直通版多素材参考Seedance 2.5 长片版长片版文生视频长片版参考图生视频长片版 -ak 通道长片版 -hig 与 -mag 通道Seedance 2.0 企业版企业版文生视频企业版参考图生视频企业版 cURL 示例请求示例纯文生视频首帧生视频首尾帧生成cURL 完整示例提交响应查询任务路径参数任务状态成功响应字段失败响应字段素材限制与建议错误