查询视频生成任务

GET

/v1/video/generations/{task_id}

查询视频生成任务的当前状态与结果。

状态流转

queued -> in_progress -> completed   视频可下载
                      -> failed      查看 error 字段

获取视频（completed 之后）

读取 metadata.url 中的直链，或

调用 GET /v1/videos/{task_id}/content 通过网关下载文件。

轮询建议

每 5 秒查询一次。

总超时约 10 分钟。

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

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Path 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

任务当前状态。

Bodyapplication/json

示例

排队中生成中已完成，视频可下载已失败

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

🟠401Unauthorized

🟠404NotFound

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

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

提交视频生成任务（OpenAI Video 别名）