1. 豆包 视频生成
梧柏API使用文档
WHBAI · Seedance 2.0
  • WHBAI · Google Gemini 原生 (v1alpha)
  • WHBAI · Google Gemini 原生
  • WHBAI · Ideogram
  • WHBAI · Ideogram V3
  • WHBAI · Midjourney
  • WHBAI · Jimeng
  • WHBAI · Kling
  • WHBAI · Luma
  • WHBAI · Luma V1
  • WHBAI · Omni 视频
  • WHBAI · Pixverse
  • WHBAI · Runway
  • WHBAI · Sora2
  • WHBAI · 统一视频 VEO
  • WHBAI · Vidu
  • WHBAI · 豆包 Volc
  • WHBAI · Suno
  • WHBAI · Playground
  • WHBAI · 账号与令牌
  • WHBAI · 阿里 Pix
  • WHBAI · 阿里百炼
  • WHBAI · 私域人像
  • WHBAI · Fal.ai
  • WHBAI · Replicate
  • WHBAI · 腾讯云 VOD
  • WHBAI · MiniMax
  • WHBAI · 支持模型列表
  • WHBAI · Grok Imagine
  • WHBAI · Seedance 2.0
  • WHBAI · TypeSafe
  • WHBAI · OpenAI 兼容
  • 视频生成
    • 豆包 视频生成
      • 创建视频生成任务(doubao-2.5)
        POST
      • doubao-2.5 查询视频生成任务
        GET
  • Seedance 2.0
    • 查询任务列表
      GET
    • 查询单个任务
      GET
    • 取消任务
      DELETE
  • seedance
    • 查询任务
      GET
  • 数据模型
    • SeedanceSampleRequest
    • NewApiError
  1. 豆包 视频生成

创建视频生成任务(doubao-2.5)

POST
/api/v3/contents/generations/tasks
实际请求:POST /api/v3/contents/generations/tasks
https://www.volcengine.com/docs/82379/1520757?lang=zh
模型固定 doubao-seedance-2-5-260628。分辨率支持 480p、720p、1080p,不支持 4k,不传时默认 720p。 duration 取值 4–30,或 -1(由模型选择)。带参考视频的参考生视频请传 omni_reference_task_type=reference;若被判定为视频编辑,ratio 只能为 adaptive,duration 只能为 -1。

网站中的模型与调用示例#

创建视频生成任务#

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "content": {
      "description": "多模态内容,text 在前,image_url 在后",
      "examples": [
        [
          {
            "text": "图片1中的角色向镜头微笑,高清电影感。",
            "type": "text"
          },
          {
            "image_url": {
              "url": "asset://asset-20260318071009-xxxxx"
            },
            "role": "reference_image",
            "type": "image_url"
          }
        ]
      ],
      "items": {
        "properties": {
          "image_url": {
            "properties": {
              "url": {
                "description": "私域素材用 asset://{AssetId}(须已 Active)",
                "examples": [
                  "asset://asset-20260318071009-xxxxx"
                ],
                "type": "string"
              }
            },
            "type": "object"
          },
          "role": {
            "description": "type=image_url 时填写",
            "examples": [
              "reference_image"
            ],
            "type": "string"
          },
          "text": {
            "description": "type=text 时填写。用「图片1」指代参考图",
            "examples": [
              "图片1中的角色向镜头微笑,高清电影感。"
            ],
            "type": "string"
          },
          "type": {
            "enum": [
              "text",
              "image_url"
            ],
            "examples": [
              "text"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "duration": {
      "description": "视频时长(秒,可选)",
      "examples": [
        5
      ],
      "type": "integer"
    },
    "generate_audio": {
      "description": "是否生成音频(可选)",
      "examples": [
        true
      ],
      "type": "boolean",
      "x-i18n": {
        "en-US": {
          "description": "Whether to generate audio(Optional)"
        }
      }
    },
    "model": {
      "enum": [
        "doubao-seedance-2-0-260128",
        "doubao-seedance-2-0-fast-260128"
      ],
      "type": "string",
      "x-apifox-enum": [
        {
          "description": "",
          "name": "",
          "value": "doubao-seedance-2-0-260128"
        },
        {
          "description": "",
          "name": "",
          "value": "doubao-seedance-2-0-fast-260128"
        }
      ]
    },
    "ratio": {
      "description": "视频比例,如 16:9 / 9:16 / 1:1(可选)",
      "examples": [
        "16:9"
      ],
      "type": "string"
    }
  },
  "required": [
    "model",
    "content"
  ]
}

请求示例 · 示例 1#

{
  "content": [
    {
      "text": "全程使用视频1的第一视角构图,全程使用音频1作为背景音乐。第一人称视角果茶宣传广告,seedance牌「苹苹安安」苹果果茶限定款;首帧为图片1,你的手摘下一颗带晨露的阿克苏红苹果,轻脆的苹果碰撞声;2-4 秒:快速切镜,你的手将苹果块投入雪克杯,加入冰块与茶底,用力摇晃,冰块碰撞声与摇晃声卡点轻快鼓点,背景音:「鲜切现摇」;4-6 秒:第一人称成品特写,分层果茶倒入透明杯,你的手轻挤奶盖在顶部铺展,在杯身贴上粉红包标,镜头拉近看奶盖与果茶的分层纹理;6-8 秒:第一人称手持举杯,你将图片2中的果茶举到镜头前(模拟递到观众面前的视角),杯身标签清晰可见,背景音「来一口鲜爽」,尾帧定格为图片2。背景声音统一为女生音色。",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
      },
      "role": "reference_image",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
      },
      "role": "reference_image",
      "type": "image_url"
    },
    {
      "role": "reference_video",
      "type": "video_url",
      "video_url": {
        "url": "https://pro.filesystem.site/cdn/20260403/0e80a635b859e7716671a40d836135.mp4"
      }
    },
    {
      "audio_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
      },
      "role": "reference_audio",
      "type": "audio_url"
    }
  ],
  "duration": 11,
  "generate_audio": true,
  "model": "doubao-seedance-2-0-260128",
  "ratio": "21:9",
  "watermark": false
}

创建视频生成任务(doubao-2.5)#

模型固定 doubao-seedance-2-5-260628。分辨率支持 480p、720p、1080p,不支持 4k,不传时默认 720p。 duration 取值 4–30,或 -1(由模型选择)。带参考视频的参考生视频请传 omni_reference_task_type=reference;若被判定为视频编辑,ratio 只能为 adaptive,duration 只能为 -1。

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "content": {
      "type": "array"
    },
    "duration": {
      "description": "4–30,或 -1。视频编辑任务必须为 -1",
      "type": "integer",
      "x-i18n": {
        "en-US": {
          "description": "4–30, or -1. Video editing tasks must be -1."
        }
      }
    },
    "generate_audio": {
      "type": "boolean"
    },
    "model": {
      "description": "固定 doubao-seedance-2-5-260628",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Fixed to doubao-seedance-2-5-260628"
        }
      }
    },
    "omni_reference_task_type": {
      "description": "auto、reference、edit、extend。带参考视频且指定宽高比、时长时建议 reference",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "auto, reference, edit, extend. It is recommended to use reference when there is a reference video and specified aspect ratio and duration."
        }
      }
    },
    "output_format": {
      "description": "mp4 或 mov,仅 Seedance 2.5。默认 mp4",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "mp4 or mov, only for Seedance 2.5. Default is mp4."
        }
      }
    },
    "ratio": {
      "description": "16:9、4:3、1:1、3:4、9:16、21:9、adaptive。编辑、延长、首帧、首尾帧只支持 adaptive",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive. Editing, extending, first frame, and first-last frame only support adaptive."
        }
      }
    },
    "resolution": {
      "description": "480p、720p、1080p。默认 720p,不支持 4k",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "480p, 720p, 1080p. Default is 720p, 4k is not supported."
        }
      }
    },
    "watermark": {
      "type": "boolean"
    }
  },
  "required": [
    "model",
    "content"
  ]
}

tags#

[
  "视频生成/豆包 视频生成"
]

请求参数

Body 参数application/json必填

示例
{
    "content": [
        {
            "text": "全程使用视频1的第一视角构图,全程使用音频1作为背景音乐。第一人称视角果茶宣传广告,seedance牌「苹苹安安」苹果果茶限定款;首帧为图片1,你的手摘下一颗带晨露的阿克苏红苹果,轻脆的苹果碰撞声;2-4 秒:快速切镜,你的手将苹果块投入雪克杯,加入冰块与茶底,用力摇晃,冰块碰撞声与摇晃声卡点轻快鼓点,背景音:「鲜切现摇」;4-6 秒:第一人称成品特写,分层果茶倒入透明杯,你的手轻挤奶盖在顶部铺展,在杯身贴上粉红包标,镜头拉近看奶盖与果茶的分层纹理;6-8 秒:第一人称手持举杯,你将图片2中的果茶举到镜头前(模拟递到观众面前的视角),杯身标签清晰可见,背景音「来一口鲜爽」,尾帧定格为图片2。背景声音统一为女生音色。",
            "type": "text"
        },
        {
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
            },
            "role": "reference_image",
            "type": "image_url"
        },
        {
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
            },
            "role": "reference_image",
            "type": "image_url"
        },
        {
            "role": "reference_video",
            "type": "video_url",
            "video_url": {
                "url": "https://pro.filesystem.site/cdn/20260403/0e80a635b859e7716671a40d836135.mp4"
            }
        },
        {
            "audio_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
            },
            "role": "reference_audio",
            "type": "audio_url"
        }
    ],
    "duration": 11,
    "generate_audio": true,
    "model": "doubao-seedance-2-0-260128",
    "ratio": "21:9",
    "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 'Content-Type: application/json' \
--data '{
    "content": [
        {
            "text": "全程使用视频1的第一视角构图,全程使用音频1作为背景音乐。第一人称视角果茶宣传广告,seedance牌「苹苹安安」苹果果茶限定款;首帧为图片1,你的手摘下一颗带晨露的阿克苏红苹果,轻脆的苹果碰撞声;2-4 秒:快速切镜,你的手将苹果块投入雪克杯,加入冰块与茶底,用力摇晃,冰块碰撞声与摇晃声卡点轻快鼓点,背景音:「鲜切现摇」;4-6 秒:第一人称成品特写,分层果茶倒入透明杯,你的手轻挤奶盖在顶部铺展,在杯身贴上粉红包标,镜头拉近看奶盖与果茶的分层纹理;6-8 秒:第一人称手持举杯,你将图片2中的果茶举到镜头前(模拟递到观众面前的视角),杯身标签清晰可见,背景音「来一口鲜爽」,尾帧定格为图片2。背景声音统一为女生音色。",
            "type": "text"
        },
        {
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
            },
            "role": "reference_image",
            "type": "image_url"
        },
        {
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
            },
            "role": "reference_image",
            "type": "image_url"
        },
        {
            "role": "reference_video",
            "type": "video_url",
            "video_url": {
                "url": "https://pro.filesystem.site/cdn/20260403/0e80a635b859e7716671a40d836135.mp4"
            }
        },
        {
            "audio_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
            },
            "role": "reference_audio",
            "type": "audio_url"
        }
    ],
    "duration": 11,
    "generate_audio": true,
    "model": "doubao-seedance-2-0-260128",
    "ratio": "21:9",
    "watermark": false
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "id": "cgt-202610230001-xxxx"
}
修改于 2026-10-24 18:33:18
下一页
doubao-2.5 查询视频生成任务
Built with