Seedance 查询视频生成任务
查询视频生成任务的状态。
仅支持查询最近 7 天的任务记录,时间区间为 [T-7天, T),其中 T 为请求发起时刻的 UTC 时间戳(精确到秒)。注意:视频 URL 有效期为 14 天,请及时下载或转存。
授权
在请求头中传入 Authorization: Bearer <token>。
请求头
请求内容类型。
路径参数
您需要查询的视频生成任务的 ID 。
说明:上面参数为Query String Parameters,在URL String中传入。
响应
response
视频生成任务 ID。
任务使用的模型名称和版本,模型名称-版本。
任务状态,以及相关的信息:
queued:排队中。running:任务运行中。cancelled:取消任务,取消状态24h自动删除(只支持排队中状态的任务被取消)。succeeded: 任务成功。failed:任务失败。expired:任务超时。
queued, running, cancelled, succeeded, failed, expired 错误提示信息,任务成功返回null,任务失败时返回错误数据
任务创建时间的 Unix 时间戳(秒)。
任务当前状态更新时间的 Unix 时间戳(秒)。
视频生成任务的输出内容。
本次请求使用的种子整数值。
生成视频的分辨率。
生成视频的宽高比。
生成视频的时长,单位:秒。
说明:duration 和 frames 参数只会返回一个。创建视频生成任务时未指定 frames,会返回 duration。
生成视频的帧数。
说明:duration 和 frames 参数只会返回一个。创建视频生成任务时指定了 frames,会返回 frames。
生成视频的帧率。
生成的视频是否包含与画面同步的声音。仅 seedance 2.0 & 2.0 fast、seedance 1.5 pro 会返回该参数。
true:模型输出的视频包含同步音频。false:模型输出的视频为无声视频。
本次请求模型实际使用的工具。未使用工具时不返回。
终端用户的唯一标识符。若 创建视频生成任务 时设置了该参数,接口会原样返回此信息。
当前请求的执行优先级。
生成的视频是否为 Draft 视频。仅 seedance 1.5 pro 会返回该参数。
true:表示当前输出为 Draft 视频。false:表示当前输出为正常视频。
Draft 视频任务 ID。基于 Draft 视频生成正式视频时,会返回该参数。
实际处理任务使用的服务等级。
任务超时阈值,单位:秒。
本次请求的 token 用量。