查询视频生成任务（豆包原生）

GET

/doubao/api/v3/contents/generations/tasks/{task_id}

查询以豆包原生格式提交的任务的当前状态与结果。

状态流转

pending -> processing -> succeeded   视频可下载
                      -> failed      查看 error 字段

轮询建议

每 5 秒查询一次。

总超时约 10 分钟。

多数 Seedance 任务在 1 到 3 分钟内完成。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Path 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/doubao/api/v3/contents/generations/tasks/task_abc123def456' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200

application/json

任务当前状态。

Bodyapplication/json

示例

排队中生成中已完成已失败

{
    "id": "task_abc123def456",
    "model": "doubao-seedance-2-0-260128",
    "status": "pending",
    "created_at": 1712345678,
    "updated_at": 1712345678
}

🟠401Unauthorized

🟠404NotFound

修改于 2026-10-27 14:24:46

提交视频生成任务（豆包原生）

提交视频生成任务（OpenAI 兼容）