Skip to main content
GET

Seedance 2.0 查询视频任务

这个接口用于查询 Seedance 2.0 异步视频任务的最新状态。
  • 根据创建任务返回的 id 查询
  • 任务完成后返回 video_url
  • 失败任务会返回 error
  • 状态统一为 queuedin_progresscompletedfailed

方法与路径

响应示例

认证

Path Parameters

string
required
视频任务 ID。创建视频任务接口返回的 id,例如 task_01jz8s3dbke8p9vq2m8r9a7gk4

Response

string
对象类型,通常为 video
string
视频任务 ID。
string
任务状态。支持 queuedin_progresscompletedfailed
integer
创建时间戳。
string
任务使用的模型名称。
string
任务完成时返回的视频 URL。
integer
实际生成的视频时长。上游返回该字段时透出。
integer
任务计费用量。上游返回该字段时透出。
string
任务失败原因。

状态映射

使用场景

轮询到任务完成

创建任务后保存返回的 id,每隔数秒调用一次查询接口。statuscompleted 时读取 video_url

获取失败原因

statusfailed 时,读取 error 字段定位失败原因。

注意事项

  • 查询接口只读取任务状态,不会重新提交生成任务。
  • video_url 只在任务完成且上游返回结果地址后出现。
  • 如果需要代理下载视频内容,可使用 GET /v1/videos/{id}/content

相关页面