Skip to main content
GET
查询视频生成任务状态
使用创建视频任务时返回的 task_id 查询生成状态。任务成功后,响应中会包含视频地址。
建议每 10-15 秒轮询一次。视频生成通常需要几十秒到数分钟。

轮询示例

Python

请求头

Authorization
string
必填

API Key token (Bearer sk-xxx)

Content-Type
string

路径参数

taskId
string
必填

响应

200 - application/json

通用视频任务状态查询响应

task_id
string

任务ID

video_url
string

视频地址(成功时;上游地址)

video_duration
number

视频时长(秒,成功时)

error_code
string

错误码(失败时)

error_message
string

错误信息(失败时)

status
string

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

resolution
string

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

ratio
string

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

model
string

平台模型编号(model_no,用于协议透传时替换上游 model 名称)

created
integer<int64>

创建时间(epoch 毫秒)-UTC标准时间

updated
integer<int64>

更新时间(epoch 毫秒)-UTC标准时间

usage
object

用量统计(成功时;时长类取自万相 usage,token 类取自 seedance usage)