1. 视频生成（OpenAI兼容）
豆包2.0视频生成 API
  • 视频生成（豆包原生）
    • 提交视频生成任务（豆包原生格式）
      POST
    • 查询视频生成任务状态（豆包原生格式）
      GET
  • 视频生成（OpenAI兼容）
    • 提交视频生成任务（OpenAI 兼容格式）
      POST
    • 查询视频生成任务状态
      GET
    • 提交视频生成任务（OpenAI 兼容格式）
      POST
    • 查询任务状态（OpenAI 兼容格式）
      GET
  • 视频内容
    • 下载视频原始文件
      GET
  • 素材资产管理
    • 创建素材资产组合（CreateAssetGroup）
      POST
    • 查询素材资产组合信息（GetAssetGroup）
      POST
    • 更新素材资产组合信息（UpdateAssetGroup）
      POST
    • 创建素材资产（CreateAsset）
      POST
    • 查询素材资产信息（GetAsset）
      POST
    • 查询素材资产列表（ListAssets）
      POST
    • 删除素材资产（DeleteAsset）
      POST
    • 删除素材资产组（DeleteAssetGroup）
      POST
  • 数据模型
    • VideoGenerationRequest
    • VideoMetadata
    • ContentItem
    • VideoTaskResponse
    • VideoTaskError
    • ErrorResponse
    • DoubaoNativeVideoRequest
    • DoubaoNativeContentItem
    • DoubaoNativeVideoResponse
    • CreateAssetGroupRequest
    • CreateAssetGroupResponse
    • GetAssetGroupRequest
    • GetAssetGroupResponse
    • UpdateAssetGroupRequest
    • UpdateAssetGroupResponse
    • CreateAssetRequest
    • CreateAssetResponse
    • AssetItem
    • ListAssetsRequest
    • GetAssetRequest
    • DeleteAssetRequest
    • DeleteAssetGroupRequest
    • ListAssetsResponse
    • GetAssetResponse
  1. 视频生成（OpenAI兼容）

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

POST
https://api.example.com/v1/video/generations
向豆包 Seedance 2.0 视频模型提交一个视频生成任务（异步）。

⭐ 真人过白（subject_type=person）#

在 metadata.content 数组的 image_url 类型条目中添加 "subject_type": "person"，即可触发真人过白功能。
请求关键字段：
{
  "metadata": {
    "content": [
      {
        "type": "image_url",
        "image_url": { "url": "https://..." },
        "subject_type": "person",
        "role": "reference_image"
      }
    ]
  }
}
⚠️ 注意：subject_type: person 时图片只支持 URL 格式，不支持 Base64，否则报错： > Only URL inputs are supported for image, video, and audio assets. Base64 encoding is not supported.
提交成功后立即返回任务 ID，视频不会即时生成完毕。
请使用返回的 id 轮询 GET /v1/video/generations/{task_id} 查询任务状态。
请求格式：使用 new-api 内部格式（OpenAI 兼容）
扩展参数需放在 metadata 对象中
时长使用 seconds 字段（字符串类型）
支持的生成场景：
场景所需字段
真人过白model + prompt + metadata.content（含 subject_type=person）
文生视频model + prompt
图生视频model + prompt + image（图片URL）
视频续拍model + prompt + metadata.content（含 video_url）
⚠️ 计费提示：视频时长影响费用，seconds="-1" 时由模型自动选择，实际时长可通过查询 API 的 duration 字段获取。
💡 格式提示：如需使用豆包原生格式，请使用 POST /api/v3/contents/generations/tasks 路由。

请求参数

Authorization
JWT Bearer
在 Header 添加参数
Authorization
示例：
Authorization: ********************
or
Body 参数application/json必填

示例
{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "一个女孩在时代广场上跳中国舞",
    "metadata": {
        "content": [
            {
                "type": "image_url",
                "image_url": {
                    "url": "https://eos.forcepic.com/uploads/20260421/69e73e5ceef05.png"
                },
                "subject_type": "person",
                "role": "reference_image"
            }
        ],
        "generate_audio": true,
        "resolution": "720p",
        "ratio": "16:9",
        "duration": 15,
        "seed": -1,
        "watermark": false
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.example.com/v1/video/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "一个女孩在时代广场上跳中国舞",
    "metadata": {
        "content": [
            {
                "type": "image_url",
                "image_url": {
                    "url": "https://eos.forcepic.com/uploads/20260421/69e73e5ceef05.png"
                },
                "subject_type": "person",
                "role": "reference_image"
            }
        ],
        "generate_audio": true,
        "resolution": "720p",
        "ratio": "16:9",
        "duration": 15,
        "seed": -1,
        "watermark": false
    }
}'

返回响应

🟢200
application/json
任务提交成功（此时任务仍在排队，status 为 queued）
Bodyapplication/json

示例
{
    "id": "task_abc123def456",
    "task_id": "task_abc123def456",
    "object": "video",
    "model": "doubao-seedance-2-0-260128",
    "status": "queued",
    "progress": 0,
    "created_at": 1712345678
}
🟠400
🟠401
🟠402
🔴500
修改于 2026-05-19 09:04:28
上一页
查询视频生成任务状态（豆包原生格式）
下一页
查询视频生成任务状态
Built with