查询视频生成任务状态（豆包原生格式）

GET

https://api.example.com/api/v3/contents/generations/tasks

查询通过豆包原生格式提交的视频生成任务的当前状态和结果。

返回豆包原生格式的响应，与豆包官方 API 格式完全一致。

任务状态流转：

pending → processing → succeeded  ✅ 可下载视频
                     ↘ failed     ❌ 查看 error 字段

轮询建议：

每 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/api/v3/contents/generations/tasks' \
--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
}

🟠401

🟠404

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

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

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