创建火山原生视频任务

使用与火山方舟一致的请求字段创建 Seedance 2.0 视频任务，响应不经过 EaseRouter 统一格式包装。

最后更新: 2026-08-31

本页内容

POST/api/v3/contents/generations/tasks

创建 Seedance 2.0 标准版视频任务；使用 EaseRouter API Key Bearer 鉴权。

请求头

参数	类型	要求	说明
`Authorization`	string	必填	Bearer <EaseRouter API Key>。
`Content-Type`	string	必填	固定为 application/json。
`X-Request-Id`	string	可选	可选幂等编号，最长 64 个安全字符。同一 API Key、协议和载荷重放返回首次任务；不同载荷复用返回 HTTP 409。

请求参数

参数	类型	要求	说明
`model`	string	必填	固定为 doubao-seedance-2-0-260128。
`content`	object[]	必填	保持原始顺序的 text、image_url、video_url、audio_url 内容。媒体 URL 使用 {"url":"https://..."} 或 {"url":"asset://平台素材ID"} 对象。
`callback_url`	string	可选	公网 HTTP/HTTPS 回调地址。状态变化时推送与查询接口相同的响应体。
`return_last_frame`	boolean	可选	是否返回尾帧，默认 false。
`generate_audio`	boolean	可选	是否生成同步音频，默认 false。
`tools`	object[]	可选	模型工具列表，每项包含 type；实际是否使用以查询结果为准。
`safety_identifier`	string	可选	终端用户稳定唯一的英文标识，最多 64 个字符，建议使用不可逆哈希。
`service_tier`	string	可选	当前仅允许 default，默认 default。
`execution_expires_after`	integer	可选	执行有效期 3600-259200 秒，默认 172800。
`resolution`	string	可选	480p、720p 或 1080p，默认 720p。
`ratio`	string	可选	16:9、4:3、1:1、3:4、9:16、21:9 或 adaptive，默认 adaptive。
`duration`	integer	可选	4-15 秒或 -1；未传时由模型服务采用默认行为。
`seed`	integer	可选	-1 至 4294967295。
`watermark`	boolean	可选	是否添加水印，默认 false。

content 结构

type	值字段	role
text	text	不传
image_url	image_url.url	first_frame、last_frame、reference_image
video_url	video_url.url	reference_video
audio_url	audio_url.url	reference_audio

{
  "type": "image_url",
  "image_url": { "url": "asset://asset-1111111111111111111111111111111101" },
  "role": "reference_image"
}

多模态创建示例

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    { "type": "text", "text": "参考图片、视频和音频生成一段电影感短片" },
    { "type": "image_url", "image_url": { "url": "https://media.example/reference.png" }, "role": "reference_image" },
    { "type": "video_url", "video_url": { "url": "https://media.example/reference.mp4" }, "role": "reference_video" },
    { "type": "audio_url", "audio_url": { "url": "https://media.example/reference.mp3" }, "role": "reference_audio" }
  ],
  "callback_url": "https://client.example/callbacks/video",
  "return_last_frame": true,
  "generate_audio": true,
  "tools": [{ "type": "web_search" }],
  "safety_identifier": "user_hash_7e91b1",
  "service_tier": "default",
  "execution_expires_after": 172800,
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": 11,
  "seed": -1,
  "watermark": false
}

成功响应

{
  "id": "cgt-20260831123045-a1b2c"
}

创建成功仅表示任务已进入异步处理链路。请保存 id，并调用原生查询接口获取状态和结果。任务编号及查询记录保留七天。