1. 视频生成
HBoom
  • 豆包
    • 视频生成
      • 创建视频生成任务(Seedance 2.0)
        POST
      • 查询视频生成任务列表
        GET
      • 查询单个视频生成任务
        GET
      • 删除视频生成任务
        DELETE
    • 素材分组
      • CreateAssetGroup 建素材分组(虚拟人像 AIGC)
      • DeleteAssetGroup 删除素材分组
      • GetAssetGroup 查询单个分组信息
      • UpdateAssetGroup 更新分组(名称/描述)
    • 素材
      • CreateAsset 入库素材(传 URL,异步)
      • GetAsset 查询素材状态(轮询)
      • ListAssets 列出素材(Filter 过滤)
      • UpdateAsset 更新素材(如备注名)
      • DeleteAsset 删除素材
    • 真人认证
      • CreateVisualValidateSession 发起真人 H5 认证
      • GetVisualValidateResult 换取真人 GroupId(通常平台内部自动调用)
  1. 视频生成

创建视频生成任务(Seedance 2.0)

POST
/api/v3/contents/generations/tasks
提交视频生成任务。content 内通过 asset://hb-xxxx 引用平台素材(素材须为 Active);平台会自动还原为火山真实引用并强制路由到素材所属渠道。
同一请求引用的多个素材须属于同一渠道,否则报「素材不可跨渠道混用」。

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Body 参数application/json必填

示例
{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "使用图1的角色,生成一个头型变换三种的视频,每组保留 3s"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "asset://hb-xxxxxxxx"
            },
            "role": "reference_image"
        }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 11,
    "watermark": false
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/v3/contents/generations/tasks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "使用图1的角色,生成一个头型变换三种的视频,每组保留 3s"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "asset://hb-xxxxxxxx"
            },
            "role": "reference_image"
        }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 11,
    "watermark": false
}'

返回响应

🟢200
成功,返回任务 id
该响应没有 Body
修改于 2026-06-23 11:14:56
下一页
查询视频生成任务列表
Built with