查询 Seedance 视频任务

GET

/v1/videos/{task_id}

查询任务状态。建议轮询间隔不低于 10 秒，并在 completed 或 failed 后停止轮询。

状态含义：queued 排队中，in_progress 生成中，completed 已完成，failed 失败。成功时视频地址位于 metadata.url。

请求参数

Path 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

任务状态和生成结果。

Bodyapplication/json

示例

生成中生成完成生成失败

{
    "id": "task_01k2example",
    "task_id": "task_01k2example",
    "object": "video",
    "model": "doubao-seedance-2-0-260128",
    "status": "in_progress",
    "progress": 50,
    "created_at": 1786400000
}

🟠400请求有误

🟠401没有权限

🔴500服务器错误

修改于 2026-08-11 05:48:00

创建 Seedance 视频生成任务

下载 Seedance 生成视频