1. 视频生成(豆包原生)
豆包2.0视频生成 API
  • 视频生成(豆包原生)
    • 提交视频生成任务(豆包原生格式)
      POST
    • 查询视频生成任务状态(豆包原生格式)
      GET
  • 视频生成(OpenAI兼容)
    • 提交视频生成任务(OpenAI 兼容格式)
      POST
    • 查询视频生成任务状态
      GET
    • 提交视频生成任务(OpenAI 兼容格式)
      POST
    • 查询任务状态(OpenAI 兼容格式)
      GET
  • 视频内容
    • 下载视频原始文件
      GET
  • 数据模型
    • VideoGenerationRequest
    • VideoMetadata
    • ContentItem
    • VideoTaskResponse
    • DoubaoNativeVideoRequest
    • VideoTaskError
    • DoubaoNativeContentItem
    • ErrorResponse
    • DoubaoNativeVideoResponse
  1. 视频生成(豆包原生)

查询视频生成任务状态(豆包原生格式)

GET
/api/v3/contents/generations/tasks
查询通过豆包原生格式提交的视频生成任务的当前状态和结果。
返回豆包原生格式的响应,与豆包官方 API 格式完全一致。
任务状态流转:
pending → processing → succeeded  ✅ 可下载视频
                     ↘ failed     ❌ 查看 error 字段
轮询建议:
每 5 秒查询一次
总超时建议设置为 10 分钟
Seedance 2.0 通常在 1~3 分钟内完成生成

请求参数

Authorization
JWT Bearer
在 Header 添加参数
Authorization
示例:
Authorization: ********************
or
Path 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/v3/contents/generations/tasks' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200
application/json
查询成功(任务可能处于任意状态)
Body

示例
{
    "id": "task_abc123def456",
    "model": "doubao-seedance-2-0-260128",
    "status": "pending",
    "created_at": 1712345678,
    "updated_at": 1712345678
}
🟠401
🟠404
修改于 2026-04-30 09:14:09
上一页
提交视频生成任务(豆包原生格式)
下一页
提交视频生成任务(OpenAI 兼容格式)
Built with