Skip to main content
GET
查询任务(seedance 兼容协议响应)
使用创建任务时返回的 id 查询状态。响应保持 Seedance 协议字段,成功后可从 content.video_url 获取视频地址。
建议每 10-15 秒轮询一次。设置 return_last_frame: true 后,成功响应还会包含可用于衔接下一段视频的尾帧地址。

轮询示例

Python

请求头

Authorization
string
必填

API Key token (Bearer sk-xxx)

Content-Type
string

路径参数

taskId
string
必填

响应

200 - application/json
created_at
integer<int64>

任务创建时间(Unix 时间戳,秒)

updated_at
integer<int64>

任务最后更新时间(Unix 时间戳,秒)

framespersecond
integer

生成视频帧率

generate_audio
boolean

生成视频帧率 生成的视频是否包含与视觉同步的音频。此参数仅在seedance 2.0 & 2.0 fast和seedance 1.5 pro中支持。 true:模型输出一个同步音频的视频。 false:输出无声视频。

safety_identifier
string

终端用户的唯一标识符。如果在创建视频生成任务时设置此参数,则API将返回不变的参数。

service_tier
string

服务层级:default 在线推理 / flex 离线推理

execution_expires_after
integer

任务超时阈值(秒),以秒为单位

draft_task_id
string

草稿视频任务ID。当根据草稿视频生成正式视频时,返回该参数

id
string

任务ID

model
string

模型名称

status
string

任务状态:queued / running / succeeded / failed / expired / cancelled

error
object

错误信息(任务失败时返回)

content
object

生成结果内容(任务成功时返回)

usage
object

Token 用量统计

seed
integer<int64>

随机种子

resolution
string

生成视频分辨率:480p / 720p / 1080p / 4k

ratio
string

生成视频宽高比:16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9

duration
integer

生成视频时长(秒)

frames
string

生成视频帧数 注意:只返回duration和frames参数中的一个。如果在创建视频生成请求中指定了帧数,则将返回帧数。

priority
integer

当前请求的执行优先级

draft
boolean

生成的视频是否为草稿视频。此参数仅由seedance 1.5 pro返回。 true:当前输出为草稿视频。 false:当前输出为标准视频。