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

查询任务状态

当 data.status 为 SUCCESS 时,结算依据见 data.billing.billable_tokens(取自上游 usage.total_tokens,Seedance 任务中与 completion_tokens 恒等,来源字段见 billing.billing_token_field)。data.data 是上游任务查询的完整原始响应(实际模型版本、实际分辨率 / 时长 / 帧率、seed、generate_audio 等);data.billing 为本任务的结算快照(最终金额与锁定的价格参数),可用于逐任务对账。doubao-seedance-2-0-fast、doubao-seedance-2-0-mini 不支持 1080p / 4k;doubao-seedance-2-5 支持到 1080p、不支持 4k。传不支持档位会被服务端拒绝。

参数说明

string
default:"doubao-seedance-2-0"
required
Token 计费模型:doubao-seedance-2-5、doubao-seedance-2-0、doubao-seedance-2-0-fast 或 doubao-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 支持到 4k;doubao-seedance-2-5 支持 480p / 720p / 1080p;fast / mini 仅 480p/720p。与 metadata.resolution 等价,后者优先。不支持像素串(如 1280x720)。
string
输出分辨率,取值同上。具体像素由 resolution 与 metadata.ratio(如 16:9)共同决定。
string[]
图生视频时传入公网图片 URL 列表。传入后按含媒体输入档计费。复杂多模态请使用 metadata.content(见 视频生成)。
array
高级多模态内容;含 image_url / video_url / audio_url 或 asset:// 时按含媒体输入档计费。
string
仅 Seedance 2.5:全模态参考任务的子类型引导,可选 auto(默认)、reference、edit、extend。显式指定后按对应子任务约束前置校验(edit 要求 content 含 reference_video(或裸 video_url)、ratio=adaptive 且 duration=-1;extend 要求 content 含 reference_video(或裸 video_url)、ratio=adaptive;reference 无特殊限制),减少异步报错。

响应体

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