Seedance 系列
Seedance 系列
字节跳动 Seedance 视频生成:文生 / 图生 / 首尾帧 / 多模态参考,2.5 另有视频编辑与延长,按分辨率档 × 秒数计费
POST
Seedance 系列
字节跳动 Seedance 视频生成系列:1.0 两档做文生视频与首尾帧控制,1.5 Pro 加上多图参考与原生音频,2.0 三档把参考素材扩展到图片、视频和音频,2.5 在此之上多出视频编辑与视频延长两个动作。本页覆盖已上架的七个模型,它们共用同一个任务接口和同一套通用参数,差异集中在可选分辨率、时长范围、可接收的参考素材种类与数量上,换档只改
提交成功后返回
素材引用(
只有成功出片才计费。任务失败、取消,或上游返回成功但没有可交付视频时,全额退款。最终费用以任务响应里的
model。
Seedance 是视频模型;同名的图像模型是 Seedream 系列,两者的参数与计费方式都不同。
快速开始
task_id。用 GET /v1/tasks/{task_id} 查询结果,也可以用 Prefer: wait 在一次调用里等待,或配置 Webhook。
edit 与 extend 接的是视频链接,不是上一步的 task_id:先用 generate 出片,从任务结果的 result.videos[].url 取到视频地址,再把它放进 video_urls 提交下一步。想接着做同一条片子的续集,也可以在上一步带 return_last_frame,用返回的尾帧图当下一次的 first_frame_image。
请求参数
string
必填
模型 ID,取值见「可用模型」。
string
默认值:"generate"
generate:生成视频,所有模型都支持edit:编辑源视频,仅seedance-2.5extend:延长源视频,仅seedance-2.5
edit 与 extend 都必须提供 video_urls,并使用 adaptive 画幅。string
必填
视频描述或编辑指令。
seedance-2.0、seedance-2.0-fast、seedance-2.0-mini 在带参考素材时提示词可选,其余情况必填。integer
输出时长(秒),整数。取值范围按模型不同:
seedance-1.0-pro 与 seedance-1.0-pro-fast 为 2–12,seedance-1.5-pro 为 4–12,2.0 三档为 4–15,seedance-2.5 为 4–30。seedance-2.5 的语义值:generate、extend传0:由模型自定时长(4–30 秒),按实际生成的时长结算edit传0:输出沿用源视频时长
string
输出分辨率,各模型可选档位见「可用模型」。默认值:
seedance-1.0-pro 与 seedance-1.0-pro-fast 为 1080p,其余模型为 720p。string
画面比例:
16:9、9:16、1:1、4:3、3:4、21:9。2.x 四个模型另支持 adaptive(跟随输入素材)。默认值:seedance-2.5 为 adaptive,其余模型为 16:9。2.x 的首帧、首尾帧任务以及 edit、extend 都只能用 adaptive。integer
默认值:"1"
生成数量,取值
1。每次任务返回一个视频。integer
随机种子。相同请求与相同种子生成相近结果。
string
首帧图片 URL。所有模型都支持。
string
尾帧图片 URL,必须与
first_frame_image 一起提供。seedance-1.0-pro-fast 不支持。string[]
参考图 URL 数组。
seedance-1.5-pro 最多 2 张,2.0 三档最多 9 张,seedance-2.5 最多 30 张;seedance-1.0-pro 与 seedance-1.0-pro-fast 不接受该字段。传首帧或尾帧时不能同时传参考图;seedance-1.5-pro 与 2.0 三档不能与 image_with_roles 同时传。string[]
参考视频 URL 数组。2.0 三档最多 3 段、总时长 2–15 秒,
seedance-2.5 最多 10 段、总时长 2–30 秒;1.0 与 1.5 不接受该字段。seedance-2.5 的 edit 与 extend 用它传源视频。string[]
参考音频 URL 数组。2.0 三档最多 3 段、总时长不超过 15 秒,
seedance-2.5 最多 10 段、总时长不超过 30 秒、单段 2–30 秒;1.0 与 1.5 不接受该字段。boolean
默认值:"true"
是否生成带声音的视频。
seedance-1.5-pro 与 2.x 四个模型支持;seedance-1.0-pro 与 seedance-1.0-pro-fast 不支持。boolean
是否给输出视频加水印。仅
seedance-2.5 支持。object[]
带角色的图片数组,与
first_frame_image、last_frame_image 合并发送。每项包含 url 和 role,所有模型都支持。role 取值:seedance-1.0-pro、seedance-1.5-pro:first_frame或last_frame,各最多一张seedance-1.0-pro-fast:只能取first_frame- 2.0 三档与
seedance-2.5:first_frame、last_frame或reference_image
seedance-1.5-pro 与 2.0 三档不能与 image_urls 同时传。boolean
默认值:"false"
固定镜头,减少相机运动。仅
seedance-1.5-pro 的 generate 支持。boolean
默认值:"false"
额外返回尾帧图,便于连续生成。2.x 四个模型支持。
object[]
增强工具列表,目前仅支持
[{"type": "web_search"}],生成时参考联网信息。2.x 四个模型支持。string
默认值:"mp4"
输出视频封装格式,
mp4 或 mov。仅 seedance-2.5 支持。string
默认值:"auto"
generate 时的参考模式提示,auto 或 reference。传 reference 会在提交时按参考生视频的约束校验,不合法直接返回 400,不建任务也不计费。edit 与 extend 由 action 决定,不需要这个字段。仅 seedance-2.5 支持。素材引用(asset://)
seedance-2.0、seedance-2.0-fast、seedance-2.0-mini、seedance-2.5 的媒体字段可以直接填 asset://<素材 ID>,引用在素材库上传的素材,可与普通链接混用:
只能引用本账号已激活的素材;素材不存在、不属于本账号或未激活时返回
400,不计费。其余模型不接受 asset://。
通用的 callback_url、callback_events、Prefer: wait、Idempotency-Key 和费用上限请求头见提交任务。
以上之外的参数会返回 400,不计费。
限制
- 每次任务只生成一个视频。
- 该模型必须提供提示词。(
seedance-1.0-pro、seedance-1.0-pro-fast、seedance-1.5-pro、seedance-2.5) - 纯文生视频必须提供提示词;有参考素材时提示词可选。(
seedance-2.0、seedance-2.0-fast、seedance-2.0-mini) - generate/extend 必须明确传入 2–12 秒时长。(
seedance-1.0-pro、seedance-1.0-pro-fast) - generate/extend 必须明确传入 4–12 秒时长。(
seedance-1.5-pro) - generate/extend 必须明确传入 4–15 秒时长。(
seedance-2.0、seedance-2.0-fast、seedance-2.0-mini) - generate/extend 必须传入 duration:4–30 秒,或传 0 由模型自定时长。(
seedance-2.5) - 尾帧必须与首帧一起提供。(
seedance-1.0-pro-fast之外的模型) - 首尾帧不能与一般图片引用混用。
- 2.x 首帧任务必须使用 adaptive 画幅。
- 2.x 首尾帧任务必须使用 adaptive 画幅。
- 最多提供两张参考图。(
seedance-1.5-pro) - 参考视频必须是可读取时长的 HTTP(S) MP4/MOV/WebM,或本人已激活的 asset:// 视频素材;总时长须为 2–15 秒。(
seedance-2.0、seedance-2.0-fast、seedance-2.0-mini) - 参考视频必须是可读取时长的 HTTP(S) MP4/MOV/WebM,或本人已激活的 asset:// 视频素材;总时长须为 2–30 秒。(
seedance-2.5) - Seedance 2.0 系列不接受纯音频参考。
- image_with_roles 不能与 image_urls 同时使用。(
seedance-1.5-pro、seedance-2.0、seedance-2.0-fast、seedance-2.0-mini) - 视频编辑需要源视频、adaptive 画幅,输出时长沿用源视频。(
seedance-2.5·edit) - 待编辑源视频必须为 4–30 秒。(
seedance-2.5·edit) - 视频延长需要源视频并使用 adaptive 画幅。(
seedance-2.5·extend)
2.5 的子任务类型上游还会从提示词判断一次:
edit 的提示词写成删除、替换、修改一类的编辑指令,extend 的提示词写成继续、往后接一类的续拍指令,与 action 保持一致。
计费
按输出分辨率档 × 输出秒数计费。同一模型下分辨率越高越贵;同一分辨率下,seedance-2.0-mini 最便宜、seedance-2.0-fast 居中、seedance-2.0 最贵。
带参考视频(video_urls,2.0 三档与 seedance-2.5)时,费用由两项相加:
- 输出秒数按该分辨率的参考视频档单价计
- 参考视频的输入秒数按输入秒单价再计一笔
参考视频时长在提交时读取,读不到时按该模型的参考视频时长上限计入;
asset:// 素材取上传时测得的时长。参考图与参考音频不单独计费。
seedance-1.5-pro 有独立的带声档,开启 generate_audio 时按对应分辨率的带声档计;其余模型音频不改变计费档位。
seedance-2.5 提交时冻结额度(duration: 0 按 30 秒冻结),完成后按实际生成结果结算退差。
各模型的单价见
GET /v1/models 返回的 price_config,或控制台「模型市场」。看这一单实际花了多少:任务响应里的 cost(整数 quota,500,000 quota = 1 USD)。cost 为准,它是整数 quota 不是美元。
响应
任务完成
result.videos 返回生成的视频,url 是数组,expires_at 是链接过期时间(Unix 秒),过期前请自行转存。提交时带了 return_last_frame 的任务,结果里还会附带尾帧图。完整字段说明见查询任务状态。