Retrieve a video generation task

GET

/v1/video/generations/{task_id}

Return the current state and result of a video generation task.

Status flow

queued -> in_progress -> completed   video ready
                      -> failed      inspect error

Fetching the video (once completed)

Read the direct link from metadata.url, or

call GET /v1/videos/{task_id}/content to download the file through the gateway.

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

返回响应

🟢200

application/json

Current task state.

Bodyapplication/json

示例

QueuedGeneratingFinished, video can be downloadedFailed

{
    "id": "task_abc123def456",
    "object": "video",
    "model": "doubao-seedance-2-0-260128",
    "status": "queued",
    "progress": 0,
    "created_at": 1712345678
}

🟠401Unauthorized

🟠404NotFound

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

Submit a video generation task (OpenAI compatible)

Submit a video generation task (OpenAI Video alias)