Seedance 官转视频 API 规范

Seedance 2.0 Mini、2.0、2.0 Fast 与 2.5 的分辨率、时长、比例、参考素材、虚拟人像库、样片、尾帧、联网搜索、取消任务和视频编辑/延长规则。

本页是 Seedance 官转视频模型的调用规范。它们与其他视频模型共用 POST /v1/videos 创建、GET /v1/videos/{id} 轮询的流程；鉴权、素材上传、轮询状态、结果下载和错误处理见视频 API 完整调用规范，本页只列出这组模型特有的字段和规则。

更新于 2026-10-13。本组模型由火山引擎 Seedance 官方接口转发，与 Seedance 官方版、SD 云厂商版是不同的模型组，参数和能力不通用。本组模型不支持 callback_url：请求中带非空 callback_url 会返回 400，不创建任务、不扣费（空字符串视为未填写）；请通过 GET /v1/videos/{id} 轮询获取结果。

模型一览

下表列出本组模型的 model ID，仅对开通了对应分组的 API Key 可见；未开通时 GET /v1/models 不会返回这些 ID。

模型	模型 ID	分辨率	时长	默认时长	图 / 视频 / 音频上限
Seedance 2.0 Mini（多分辨率）	`doubao-seedance-2.0-mini`	480P / 720P	`-1` 或 4–15 秒	5 秒	9 / 3 / 3
Seedance 2.0（多分辨率）	`doubao-seedance-2.0`	480P / 720P / 1080P / 4K	`-1` 或 4–15 秒	5 秒	9 / 3 / 3
Seedance 2.0 Fast（多分辨率）	`doubao-seedance-2.0-fast`	480P / 720P	`-1` 或 4–15 秒	5 秒	9 / 3 / 3
Seedance 2.5（多分辨率）	`doubao-seedance-2.5`	480P / 720P / 1080P	`-1` 或 4–30 秒	`-1`（自动）	30 / 10 / 10

此前的模型 ID doubao-seedance-2-0-mini-260615、doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-5-260628 仍可调用，与上表同名模型完全相同；它们已不在模型广场展示，新接入请使用上表的 ID。

通用规则

分辨率：resolution 选择输出档位，取值见上表（大小写均可，例如 720p、4k），默认 720p。
时长：duration（或 seconds）填整数秒；-1 表示由模型自动决定时长。
比例：ratio（或 aspect_ratio）可选 16:9、4:3、1:1、3:4、9:16、21:9、adaptive，默认 adaptive（按输入素材自适应）。size 也可以写比例或清晰度档位（例如 16:9、1080p），与 ratio、aspect_ratio 或 resolution 冲突时返回 400。
提示词：提供了参考素材或首尾帧时可以省略 prompt；什么都不传会返回 400。
生成音频：generate_audio（布尔值）可设为 false 关闭音频，不传时默认带音频。
可选字段：watermark（布尔值，true 时右下角加「AI 生成」水印，默认不加）、priority（0–9 的整数，排队优先级）、return_last_frame（布尔值，见尾帧）。
不支持的字段：seed、camera_fixed、frames、service_tier，发送会返回 400；draft 仅 Seedance 2.5 支持，见样片与正式视频。

计费说明

本组模型按任务完成后模型平台返回的输出 Token 结算，命中「分辨率 × 是否带参考视频」对应的单价档位。提交时不预扣费用，使用日志里会先出现一条「操作 …」的提交记录（金额为 0），任务完成后再出现一条「任务用量表达式结算」记录，按实际用量扣费。

时长由模型决定时（duration 为 -1，或 Seedance 2.5 未填写时长），提交记录里的秒数是按最大时长的预估，显示为「seconds: 30（预估）」；实际扣费以结算记录为准。失败或已取消的任务不扣费。

参考素材

参考图片放 images 数组，参考视频放 metadata.referenceVideos，参考音频放 metadata.referenceAudios。
也可以使用单数字段：image、input_reference 作为参考图片，video 作为参考视频，audio 作为参考音频。同一素材在多个字段重复填写只计一次。
每项可以是 URL 字符串，也可以是 { "url": "...", "role": "..." }。
图片接受公网 https:// URL 或 data: Data URI；音频接受公网 https:// URL 或 data: Data URI。
参考视频只接受公网 https:// URL，不接受 http://、data:、Base64 或本地文件；本地视频请先按本地素材上传取得 URL。链接须无需登录即可访问，并在任务完成前保持有效。
2.0 系列（Mini、2.0、Fast）不能只传参考音频，必须同时提供参考图片或参考视频。
参考视频、音频的累计时长建议分别不超过 15 秒（2.0 系列）和 30 秒（2.5）；超出时模型平台可能在提交后返回失败。
也可以直接使用火山方舟的 content 数组写法（text、image_url、video_url、audio_url 内容项，图片 role 可为 first_frame、last_frame 或 reference_image），放在顶层或 metadata 中均可。

{
  "model": "doubao-seedance-2.0",
  "prompt": "参考图中的人物随参考音频的节奏起舞，动作风格参考参考视频",
  "duration": 8,
  "resolution": "1080p",
  "ratio": "16:9",
  "images": ["https://cdn.example.com/dancer.jpg"],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/dance-motion.mp4"],
    "referenceAudios": ["https://cdn.example.com/music.mp3"]
  }
}

虚拟人像库（入库模式）

默认情况下，参考素材直接提交给生成接口审核。也可以先把素材放入虚拟人像库、通过入库审核后再用于生成：

图片设置 "image_source_mode": "asset"，参考视频设置 "video_source_mode": "asset"（视频仍须是公网 https:// URL）。两个字段可放在顶层或 metadata 中，互相独立。
用 multipart/form-data 上传的本地图片会自动放入虚拟人像库并按入库模式提交，无需另外设置，见文件上传。
入库审核只检查素材是否可用，不是本人实名、刷脸或活体认证；目前不提供真人授权入库流程，真人照片在入库模式下也可能审核不通过。
目前不提供独立的素材管理功能（单独上传、素材列表、素材 ID），每次生成请求都需要带上素材。

{
  "model": "doubao-seedance-2.5",
  "prompt": "图片 1 中的人物佩戴图片 2 的项链，在明亮的摄影棚中缓慢转身展示",
  "duration": 6,
  "resolution": "720p",
  "ratio": "9:16",
  "image_source_mode": "asset",
  "images": [
    { "url": "https://cdn.example.com/model.png", "role": "reference_image" },
    { "url": "https://cdn.example.com/necklace.png", "role": "reference_image" }
  ]
}

多张参考图片按提交顺序保留，请在提示词中写明「图片 1」「图片 2」各自对应的内容，避免人物或物品对应混淆。

首尾帧

首帧和尾帧放在 metadata.firstFrame 与 metadata.lastFrame，计入图片数量上限。

lastFrame 必须与 firstFrame 同时提供。
首尾帧不能与参考图片、参考视频或参考音频混用。
Seedance 2.5（多分辨率）使用首尾帧时，ratio 必须为 adaptive（或不传）。

{
  "model": "doubao-seedance-2.0-fast",
  "prompt": "从清晨的空旷广场平滑过渡到夜晚灯光亮起的同一构图",
  "duration": 5,
  "resolution": "720p",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

Seedance 2.5 的视频编辑与延长

Seedance 2.5（多分辨率）提供参考视频时，可以用 omni_reference_task_type 指定任务：

取值	说明	要求
`auto`（默认）	由模型按素材判断	输出时长跟随输入视频（`duration` 按 `-1` 处理）
`reference`	参考生成	—
`edit`	视频编辑	必须有参考视频；`ratio` 为 `adaptive`；`duration` 为 `-1`
`extend`	视频延长	必须有参考视频；`ratio` 为 `adaptive`

另外可用 output_format 选择 mp4 或 mov。这两个字段只对 2.5 生效，2.0 系列发送会返回 400。

{
  "model": "doubao-seedance-2.5",
  "prompt": "把画面中的白天改成雨夜，保留人物动作",
  "omni_reference_task_type": "edit",
  "duration": -1,
  "ratio": "adaptive",
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/source.mp4"]
  }
}

样片与正式视频（Seedance 2.5）

Seedance 2.5（多分辨率）可以先生成低成本的 480p 样片，确认效果后再基于样片生成 1080p 正式视频。其他模型不支持样片。

生成样片：请求中加 "draft": true，输出固定为 480p。样片不能同时设置 return_last_frame。
等待样片成功：照常轮询 GET /v1/videos/{id}，状态为 completed 后查看样片。
生成正式视频：content 中只放一个 draft_task，id 填样片任务的 id（创建样片时返回的 task_…）。正式视频固定 1080p，提示词、素材、时长、比例、音频等都从样片继承，不要重复传 prompt、素材、duration、ratio、generate_audio、omni_reference_task_type 或 return_last_frame，否则返回 400。

{
  "model": "doubao-seedance-2.5",
  "content": [
    { "type": "draft_task", "draft_task": { "id": "task_REPLACE_WITH_YOUR_DRAFT_TASK_ID" } }
  ],
  "watermark": false
}

只能使用本账号创建、且已成功的样片任务；请在样片创建后 7 天内生成正式视频。
样片和正式视频是两个独立计费的任务；正式视频按 1080p 档位结算，样片若带参考视频，正式视频同样按带参考视频的档位结算。

尾帧

请求中设置 "return_last_frame": true，任务成功后可以取得视频的最后一帧图片，用于续拍或作为下一段视频的首帧：

curl https://api.88api.ai/v1/tasks/task_xxx/artifacts \
  -H "Authorization: Bearer sk-你的API密钥"

返回的 artifacts 中，key 为 last_frame 的一项即为尾帧图片，按其 content_url 下载（同样携带 API Key）。尾帧不在 GET /v1/videos/{id} 的响应中返回。图片格式以下载结果的 Content-Type 为准，不保证是 PNG。

联网搜索

Seedance 2.0 系列和 2.5 支持 tools 联网搜索，适合需要实时信息的提示词：

{
  "model": "doubao-seedance-2.0",
  "prompt": "根据今天上海的天气，生成一段外滩街景视频",
  "duration": 5,
  "resolution": "720p",
  "tools": [{ "type": "web_search" }]
}

tools 只支持 {"type": "web_search"}。
是否真正发起搜索由模型根据提示词决定；只有实际发生搜索时，才按搜索次数额外计费（单价见控制台价格说明），未搜索不额外收费。

取消任务

任务还在排队、尚未开始生成时，可以取消：

curl -X DELETE https://api.88api.ai/v1/videos/task_xxx \
  -H "Authorization: Bearer sk-你的API密钥"

取消成功返回 {"id": "task_xxx", "object": "video", "status": "cancelled", "cancelled": true}，任务随后显示为失败（原因「任务已被用户取消」），不扣费。
已开始准备或生成、或已经结束的任务无法取消，返回 409 task_not_cancellable，请继续查询任务结果。
DELETE /v1/video/generations/{id} 效果相同。

官方任务 ID

任务被火山方舟受理后，GET /v1/videos/{id} 会返回 official_task_id（例如 cgt-20261012120000-abcde），控制台任务日志中也会显示「官方任务 ID」。需要核对生成问题时，请同时提供任务 id 和官方任务 ID。任务尚在排队、未被受理时不返回该字段。

文件上传

可以用 multipart/form-data 直接上传本地图片，支持多张：用同一个字段名（例如 image）重复上传，按提交顺序对应「图片 1」「图片 2」。上传的图片会自动放入虚拟人像库并按入库模式提交。

curl https://api.88api.ai/v1/videos \
  -H "Authorization: Bearer sk-你的API密钥" \
  -F model=doubao-seedance-2.5 \
  -F "prompt=图片 1 中的人物佩戴图片 2 的项链缓慢转身" \
  -F duration=6 \
  -F resolution=720p \
  -F "image=@./model.png" \
  -F "image=@./necklace.png"

使用本地文件时，不能再同时提交 images、image、input_reference 或 content 中的图片。
单个文件不超过 64 MB，整个请求不超过 128 MB。
本地视频和音频不能用 multipart/form-data 直接上传：请先按本地素材上传取得 https:// URL，再填入参考视频或参考音频字段；参考音频也可以使用 data: Data URI。

Seedance 官转视频 API 规范

目录