Seedance
Seedance 2.0 与 2.5 的模型、素材限制、Draft 生成和计费说明。
使用 POST /v1/video-generation/generate。2.5 是新增模型,2.0 Pro 和 Fast 继续保留。不传 model 仍默认使用 2.0 Fast。
认证、轮询、任务列表和错误码见 AI 视频总览.
模型限制
| Model | RPM |
|---|---|
doubao-seedance-2-pro | 5 |
doubao-seedance-2-fast | 5 |
doubao-seedance-2-5 | 5 |
| 规则 | 2.0 Pro / Fast | 2.5 |
|---|---|---|
| 提示词字符数 | 3000 | 5000 |
| 输出秒数 | 4–15 | 4–30 / -1 |
| 参考图片 | 9 | 30 |
| 参考视频 | 3 个;单个 2–15 秒,总计 ≤15 秒 | 10 个;单个 2–30 秒,总计 ≤30 秒;编辑时单个 ≥4 秒 |
| 参考音频 | 3 个;必须同时有图片或视频 | 10 个;单个 2–30 秒,总计 ≤30 秒;允许纯音频输入 |
| Resolution | Pro: 480p / 720p / 1080p; Fast: 480p / 720p | 480p / 720p / 1080p; Draft: 480p |
| 宽高比 | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive |
2.5 默认值:resolution: "720p"、ratio: "adaptive"、duration: 5、omniReferenceTaskType: "auto"、draft: false。
2.5 模式与素材元数据
omniReferenceTaskType 可选 auto(默认)、reference、edit、extend。编辑与延长必须有视频输入并使用 ratio: "adaptive";编辑还必须 duration: -1。首帧、首尾帧也必须使用 adaptive。adaptive 让上游决定输出宽高,-1 让上游决定时长,它们是明确参数值,不是省略字段。多视频编辑请在提示词中指出目标视频。
首帧使用一个 first_frame,可选一个 last_frame。帧角色不能与参考图片、视频、音频混用。参考角色分别为 reference_image、reference_video、reference_audio。
每个素材的元数据放在对应的 image_url、video_url、audio_url 对象中,与 url 同层。每个视频和音频都必须填写自己的 duration(秒)。已知时还应提供真实 width、height、size(字节),视频可提供 fps。一个总时长不能代替逐素材元数据。
图片:边长 300–6000 像素,宽高比 0.4–2.5(包含边界),文件必须小于 30 MiB。视频:边长 300–6000,宽高比 0.4–2.5,像素面积 407,696–8,295,044,24–60 fps,最大 200 MiB。音频最大 15 MiB。视频总时长与音频总时长各自不能超过 30 秒。
2.5 参考生成请求
{
"model": "doubao-seedance-2-5",
"content": [
{ "type": "text", "text": "Use Video 1 motion and Audio 1 rhythm" },
{
"type": "video_url",
"role": "reference_video",
"video_url": {
"url": "https://example.com/reference.mp4",
"width": 1280,
"height": 720,
"duration": 5,
"fps": 24,
"size": 8000000
}
},
{
"type": "audio_url",
"role": "reference_audio",
"audio_url": {
"url": "https://example.com/reference.wav",
"duration": 4,
"size": 800000
}
}
],
"omniReferenceTaskType": "reference",
"resolution": "720p",
"ratio": "16:9",
"duration": 10,
"requestId": "reference-request-unique-id"
}Draft → 正式生成
传 draft: true 与 resolution: "480p" 创建可播放草稿,轮询到 success。在创建后 14 天内,用 ListenHub 返回的 taskId 作为 draftTaskId 创建新的 1080p 正式任务。草稿必须属于当前用户和相同应用/API 身份范围。后端读取原输入和原渠道;正式请求不要重复传内容和其他生成参数。
{
"model": "doubao-seedance-2-5",
"draftTaskId": "507f1f77bcf86cd799439011",
"requestId": "final-request-unique-id"
}每次主动发起的新生成使用新的 requestId(8–128 个字符),同一次提交的网络重试复用该值,可使用 UUID。任务详情包含可选的 draft、draftTaskId、finalTaskIds;可见生成内容还可能带有 draftEpisodeId、finalEpisodeIds。
预估与结算
草稿和正式生成是两个任务,分别计费。正式生成不会抵扣草稿费用,也不会把草稿输出再次算作参考视频。正式任务失败只退回该任务的预扣费用,已成功草稿继续保留。
调用 POST /v1/video-generation/estimate-credits,提供与生成一致的模型、分辨率、比例、时长、omniReferenceTaskType、draft。referenceImages、referenceVideos、referenceAudios 是元数据数组,每项带 role 和对应文件信息,不带 URL。预估正式任务时只需 model 与 draftTaskId。
视频预估按参考视频总时长、输出时长、输出宽高与 24 fps 计算,并遵循最低 token 规则。各输入视频自己的宽高用于校验,不按各自像素面积分别计费。纯音频使用无视频输入单价,音频秒数不累加到视频秒数。自动参数采用保守预估,完成后按上游实际 token 用量结算,预估值不是保证上限。
2.5 独立使用单价表。相对 2.0 Pro,480p / 720p 的无视频、有视频单价分别上涨 52.86%、48.84%;1080p 分别上涨 51.95%、48.94%。这不意味着每个任务都按同一比例涨价,也不代表固定利润率。
OpenAPI 预估返回 tokens 与 estimatedCostUsd,不返回内部积分。提交时预扣,完成后按实际 token 多退少补。保留任务 ID,重试前先查询已有任务状态。
失败与重试
缺少单个素材时长、混用帧和参考角色、模式与比例或时长不匹配,都会在请求校验时失败。例如 edit 配 duration: 5 不合法,应使用 adaptive 与 -1。
草稿不存在或无权访问时返回 32001;草稿未成功、已过期或不符合条件时返回 32004。例如创建超过 14 天的草稿不能转正式,需要重新创建草稿。
上游审核拒绝或供应商失败通过任务失败状态和现有错误字段返回。5000 字符是产品上限,不保证上游接受。提交超时不等于应该新建任务:先查已有任务,或用相同请求 ID 重试。