Skip to main content
POST
doubao-seedance-2-5doubao-seedance-2-0doubao-seedance-2-0-fastdoubao-seedance-2-0-miniARK Token 计费。提交与查询均使用主路径 /v1/video/generations
预扣与结算:提交时按请求声明的分辨率与计费分档预扣额度;任务成功后读取 data.data.usage.completion_tokens,并按上游实际结果重新计价,多退少补。价目分档见 视频模型列表计费说明。限时促销对齐官方,具体以控制台账单为准。
超时重试请带 Idempotency-Key;响应丢失可用 GET ...?request_id= 找回,避免重复预扣。

查询任务状态

data.statusSUCCESS 时,读取 data.data.usage.completion_tokens 作为结算依据。doubao-seedance-2-0-fastdoubao-seedance-2-0-mini 不支持 1080p / 4kdoubao-seedance-2-5 支持到 1080p、不支持 4k。传不支持档位会被服务端拒绝。

参数说明

string
default:"doubao-seedance-2-0"
required
Token 计费模型:doubao-seedance-2-5doubao-seedance-2-0doubao-seedance-2-0-fastdoubao-seedance-2-0-mini。带 -480p 等后缀的别名模型按秒计费。
string
required
提示词,支持中英文。
string
default:"5"
视频时长,传字符串如 "5""-1"。用于生成请求,不参与 token 计费乘算。2.5 合法范围 4–30-1
string
default:"720p"
官方分辨率枚举。doubao-seedance-2-0 支持到 4kdoubao-seedance-2-5 支持 480p / 720p / 1080p;fast / mini 仅 480p/720p。与 metadata.resolution 等价,后者优先。不支持像素串(如 1280x720)。
string
输出分辨率,取值同上。具体像素由 resolutionmetadata.ratio(如 16:9)共同决定。
string[]
图生视频时传入公网图片 URL 列表。传入后按含媒体输入档计费。复杂多模态请使用 metadata.content(见 视频生成)。
array
高级多模态内容;含 image_url / video_url / audio_urlasset:// 时按含媒体输入档计费。
string
仅 Seedance 2.5:全模态参考任务的子类型引导,可选 auto(默认)、referenceeditextend。显式指定后按对应子任务约束前置校验(edit 要求 contentreference_video(或裸 video_url)、ratio=adaptiveduration=-1extend 要求 contentreference_video(或裸 video_url)、ratio=adaptivereference 无特殊限制),减少异步报错。

响应体

string
提交时返回的任务 ID。
integer
查询完成时上游返回的真实输出 token 数。