1. 视频生成（豆包原生）
豆包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. 视频生成（豆包原生）

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

POST
https://api.example.com/api/v3/contents/generations/tasks
使用豆包官方原生 API 格式提交视频生成任务（异步）。

⭐ 真人过白（subject_type=person）#

在 content 数组的 image_url video_url audio_url 类型条目中添加 "subject_type": "person"，即可触发真人过白功能。
请求关键字段：
{
  "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.
与 /v1/video/generations 的区别：
使用豆包原生请求格式（content 在顶层）
参数名称和结构与豆包官方 API 完全一致
适合从豆包官方 API 迁移的用户
请求格式特点：
content 数组在顶层（而非 metadata 中）
prompt 可在顶层或作为 content 数组中的 text 类型
时长使用 duration 字段（整数类型，如 5 或 -1）
其他参数（ratio、resolution、watermark 等）在顶层
支持的生成场景：
真人过白：content 含 image_url（subject_type=person）+ text 类型
文生视频：content 包含 text 类型
图生视频：content 包含 text + image_url 类型
视频续拍：content 包含 text + video_url 类型
多模态输入：content 可同时包含图片、视频、音频引用
提交成功后立即返回任务 ID，请使用 GET /api/v3/contents/generations/tasks/{task_id} 查询任务状态。
💡 格式提示：如需使用 OpenAI 兼容格式，请使用 POST /v1/video/generations 路由。

请求参数

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

示例
{
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
        {
            "type": "text",
            "text": "一个女孩在时代广场上跳中国舞"
        },
        {
            "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/api/v3/contents/generations/tasks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
        {
            "type": "text",
            "text": "一个女孩在时代广场上跳中国舞"
        },
        {
            "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 为 pending）
Bodyapplication/json

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