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

查询任务状态

当 data.status 为 SUCCESS 时,读取 data.data.usage.completion_tokens 作为结算依据。data.data 是上游任务查询的完整原始响应(实际模型版本、实际分辨率 / 时长 / 帧率、seed、generate_audio 等);请求 duration=-1(智能时长)时,其中的 duration 为官方最终选择的实际输出时长。seedance-2-0-fast、seedance-2-0-mini 不支持 1080p / 4k;seedance-2-5 支持到 1080p、不支持 4k。传不支持档位会被服务端拒绝。

参数说明

string
default:"seedance-2-0"
required
Token 计费模型:seedance-2-5、seedance-2-0、seedance-2-0-fast 或 seedance-2-0-mini。带 -480p 等后缀的别名模型按秒计费。
string
required
提示词,支持中英文。
string
default:"5"
视频时长,传字符串如 "5" 或 "-1"。用于生成请求,不参与 token 计费乘算(计费按上游返回的输出 token 据实结算)。2.5 合法范围 4–30 或 -1。
string
官方分辨率枚举。seedance-2-0 支持到 4k;seedance-2-5 支持 480p / 720p / 1080p(不含 4k);fast / mini 仅 480p/720p。与 metadata.resolution 等价,后者优先。不支持像素串(如 1280x720)。
string
输出分辨率,取值同上。优先级高于 size。具体输出像素由 resolution 与 metadata.ratio(如 16:9)共同决定。
string
仅 Seedance 2.5:输出封装 mp4(默认)或 mov。
string[]
图生视频时传入公网图片 URL。2.0 文档习惯称「含媒体输入」档;2.5 仅含视频文件才走有视频输入低价档。
array
高级多模态内容;可含 image_url / video_url / audio_url 或 asset://。2.5 素材上限约图 ≤30 / 视频 ≤10 / 音频 ≤10(合计 ≤50)。
string
仅 Seedance 2.5:全模态参考任务的子类型引导,可选 auto(默认)、reference、edit、extend。显式指定后按对应子任务约束前置校验(edit 要求 content 含 reference_video、ratio=adaptive 且 duration=-1;extend 要求 content 含 reference_video、ratio=adaptive;reference 无特殊限制),减少异步报错。
string
可选。任务完成 / 失败时上游平台向该公网地址 POST 回调任务结果,可替代轮询。并非每个渠道都支持(不支持的渠道会忽略该字段),具体适配的渠道请咨询客服,详见 任务回调。

响应体

string
提交时返回的任务 ID。
integer
查询完成时上游返回的真实输出 token 数,用于最终扣费。