Seedance 2.0 任务查询接口文档

轮询任务状态。status 流转：queued → in_progress（progress 50）→ completed（progress 100，video_url 给出成片直链）或 failed（error 给出结构化错误码）。

建议轮询间隔 10~20 秒；480p/4s 任务通常 1~2 分钟完成，时长与清晰度越高耗时越长。排队较久（超过 10 分钟未进入生成节点）会直接转为 failed，不会无限期等待，高峰期建议加自动重试。

failed 状态下 error 的常见取值：

错误码	含义
`TIMEOUT`	排队超时（超过 10 分钟未进入生成节点），不计费
`GENERATION_FAILED`	生成未成功，多为高峰期波动，重试即可
`POLICY_VIOLATION`	内容未通过平台审核，同一素材重试无效，需更换

成片直链（video_url）为可直接下载/嵌入的 MP4，支持 Range 断点续传。部分直链为带时效的临时签名地址（24 小时后过期），建议下载完成后尽快转存，不要长期依赖该直链。

✅ 可直接复制的 curl 示例

查询任务状态

{id} 使用创建任务时响应里的 id；查询响应中的 task_id 字段是上游侧标识，会与 id 不同，不能用来查询。

完成后下载成片

返回响应

🟢200

application/json

任务状态

Bodyapplication/json

示例

排队中生成中完成（video_url 为成片直链）失败（error 结构化错误，失败不计费）

{
    "id": "task_itYSMfIcOsL9Mevjzo36iqGA2qE3zqlY",
    "task_id": "task_WfjAeqcPiYhqzLlnCEvb4psOdppUnCEE",
    "model": "Seedance-2.0-fast-480p",
    "status": "queued",
    "progress": 0,
    "created_at": 1784128043,
    "seconds": "4",
    "error": null,
    "error_code": null,
    "video_url": null
}

🟠401ErrorResponse

🟠404ErrorResponse

查询视频任务状态 / 获取成片

Seedance 2.0 任务查询接口文档

✅ 可直接复制的 curl 示例

请求参数

请求示例代码

返回响应

查询视频任务状态 / 获取成片

Seedance 2.0 任务查询接口文档#

✅ 可直接复制的 curl 示例#

请求参数

请求示例代码

返回响应

Seedance 2.0 任务查询接口文档

✅ 可直接复制的 curl 示例