Retrieve a video generation task (Doubao native)

GET

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

Return the current state and result of a task submitted in Doubao native format.

Status flow

pending -> processing -> succeeded   video ready
                      -> failed      inspect error

Polling

Query every 5 seconds.

Give up after about 10 minutes.

Most Seedance jobs finish in 1 to 3 minutes.

请求参数

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

Current task state.

Bodyapplication/json

示例

QueuedGeneratingFinishedFailed

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

🟠401Unauthorized

🟠404NotFound

修改于 2026-10-27 14:29:06

Submit a video generation task (Doubao native)

Submit a video generation task (OpenAI compatible)