火山创建视频生成任务

POST /api/v3/contents/generations/tasks

火山方舟原生格式的视频生成接口，对接上游火山方舟 Seedance 系列模型。模型依据传入的文本、图片、音频、视频等信息异步生成视频；本接口提交任务后返回任务 ID，需通过 查询视频生成任务 轮询任务状态并获取生成视频地址。

⚠️ 本接口为异步接口，提交成功仅代表任务已建单。请使用返回的任务 ID 轮询查询任务状态。

请求参数

请求体沿用火山方舟原生格式并透传全部顶层参数，不同模型支持的参数与取值不同。

参数名	类型	必选	说明
model	string	必选	模型 ID 或 Endpoint ID
content	array<object>	必选	输入内容列表，支持文本、图片、音频、视频、样片任务等元素
content[].type	string	必选	内容类型：text、image_url、video_url、audio_url、draft_task
content[].text	string	可选	文本提示词（type=text 时），描述期望生成的视频
content[].image_url	object	可选	图片对象（type=image_url 时）
content[].image_url.url	string	可选	图片来源：图片 URL、Base64 编码（data:image/<格式>;base64,<...>）或素材 ID（asset://<ASSET_ID>）
content[].video_url	object	可选	视频对象（type=video_url 时）
content[].video_url.url	string	可选	视频来源：视频 URL 或素材 ID（asset://<ASSET_ID>）
content[].audio_url	object	可选	音频对象（type=audio_url 时）
content[].audio_url.url	string	可选	音频来源：音频 URL、Base64 编码（data:audio/<格式>;base64,<...>）或素材 ID
content[].draft_task	object	可选	样片任务对象（type=draft_task 时）
content[].draft_task.id	string	可选	样片任务 ID，基于样片生成正式视频
content[].role	string	可选	角色/用途：first_frame、last_frame、reference_image、reference_video、reference_audio
omni_reference_task_type	string	可选	全模态参考生视频任务类型引导，默认 auto；可选 auto、reference、edit、extend（仅 Seedance 2.5）
resolution	string	可选	视频分辨率：480p、720p、1080p、4k（取值随模型不同）
ratio	string	可选	视频宽高比：16:9、4:3、1:1、3:4、9:16、21:9、adaptive
duration	integer	可选	视频时长（秒），-1 表示模型智能选择；与 frames 二选一
frames	integer	可选	视频帧数，取值范围 [29, 289] 内满足 25 + 4n 的整数；优先级高于 duration
generate_audio	boolean	可选	是否生成有声视频，默认 true
watermark	boolean	可选	是否包含 AI 生成 水印，默认 false
output_format	string	可选	输出格式：mp4（默认）、mov（仅 Seedance 2.5）
seed	integer	可选	随机种子，默认 -1（随机）；取值范围 [-1, 2147483647]
camera_fixed	boolean	可选	是否固定摄像头，默认 false
return_last_frame	boolean	可选	是否返回生成视频的尾帧图像，默认 false
draft	boolean	可选	是否开启样片模式生成预览视频，默认 false（仅 Seedance 1.5 pro）
service_tier	string	可选	服务等级：default（在线推理，默认）、flex（离线推理）
callback_url	string	可选	任务状态变化时的回调通知地址
execution_expires_after	integer	可选	任务超时阈值（秒），默认 172800（48 小时）；取值范围 [3600, 259200]
priority	integer	可选	执行优先级，默认 0；取值范围 [0, 9]，数值越大越优先（仅 Seedance 2.5 / 2.0 系列）
safety_identifier	string	可选	终端用户唯一标识符，英文字符串，长度不超过 64 个字符
tools	array<object>	可选	工具配置（仅 Seedance 2.5 / 2.0 系列）
tools[].type	string	可选	工具类型，如 web_search（联网搜索）

请求示例

{
  "body": {
    "model": "doubao-seedance-1-5-pro-251215",
    "content": [
      {
        "type": "text",
        "text": "小猫对着镜头打哈欠"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "seed": 11,
    "camera_fixed": false,
    "watermark": true
  }
}

响应字段（200）

字段名	类型	说明
id	string	视频生成任务 ID。仅保存 7 天（从任务创建时间戳开始计算），超时后自动清除。draft=true 时为 Draft 视频任务 ID，draft=false 时为正常视频任务 ID

本接口为异步接口，获取任务 ID 后需通过 查询视频生成任务 轮询任务状态；任务成功后会输出生成视频的 video_url。

响应示例

{
  "id": "cgt-2026xxxx-xxxxx"
}