查询视频生成任务状态

GET

https://api.example.com/v1/video/generations/{task_id}

根据任务 ID 查询视频生成任务的当前状态和结果。

任务状态流转：

queued → in_progress → completed  ✅ 可下载视频
                     ↘ failed     ❌ 查看 error 字段

视频获取方式（任务 completed 后）：

从响应体 metadata.url 字段获取视频直链

调用 GET /v1/videos/{task_id}/content 通过代理下载视频文件

轮询建议：

每 5 秒查询一次

总超时建议设置为 10 分钟

Seedance 2.0 通常在 1~3 分钟内完成生成

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Path 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.example.com/v1/video/generations/task_abc123def456' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200

application/json

查询成功（任务可能处于任意状态）

Bodyapplication/json

示例

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

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

🟠401

🟠404

修改于 2026-05-19 09:04:28

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