创建任务

火山国内线已上线

这一页把创建任务的参数一次查全，并标明哪些参数我们已经实测过，哪些以火山方舟官方规格为准。

接口

POST

https://api.boyueasi.com/api/v3/contents/generations/tasks

请求头带上 Authorization: Bearer <API 密钥> 和 Content-Type: application/json，body 为 JSON。带前缀的 /doubao/api/v3/contents/generations/tasks 与它等价。完整的三步示例见快速开始。

请求体参数

参数	类型	必填	说明	核验状态
`model`	string	是	模型 ID，见「模型与规格」页。缺失时返回 model is required。	已核
`content`	array	是	内容数组，至少包含一个文本或参考项，元素写法见下文「content 元素」。缺失时返回 content is required。	已核
`duration`	integer	否	视频时长（秒）。Seedance 2.0 为 4–15，2.5 为 4–30；填 -1 由模型决定时长。超出范围时由模型方拒绝，预扣全额退回。	已核
`resolution`	string	否	输出分辨率。2.0 支持 480p、720p、1080p、4k；2.5 支持 480p、720p、1080p。不在模型范围内会被直接拒绝（400），不扣费。	已核
`ratio`	string	否	画面比例。16:9 与 9:16 已实测生效；其余取值（如 4:3、1:1、3:4、21:9、adaptive）以火山方舟官方规格为准；不填时的默认值以官方规格为准。	已核
`generate_audio`	boolean	否	是否生成音轨，默认生成。设为 false 后成片只有视频轨（Seedance 2.0 实测，2.0 关声音不降价）。2.5 以火山方舟官方规格为准。	已核
`return_last_frame`	boolean	否	设为 true 后，成功结果多出 content.last_frame_url（尾帧图，24 小时有效；Seedance 2.0 实测）。2.5 以火山方舟官方规格为准。	已核
`watermark`	boolean	否	设为 false 时，尾帧图无水印（Seedance 2.0 实测）。不填时的默认值，以及对成片水印的影响，以火山方舟官方规格为准。	已核

用火山官方 Python SDK 时，上表的字段对应 tasks.create(...) 里的同名关键字参数。

上表之外的火山方舟官方字段（例如 draft、output_format（仅 2.5）、priority、execution_expires_after、service_tier）我们没有实测，不作承诺，能否使用以火山方舟官方规格为准。

参数提示

seed：这是 Seedance 1.x 的参数，2.0 与 2.5 模型本身不提供。传入会被拒绝（HTTP 400，提示参数不受支持），不扣费。
获取结果：用查询接口轮询任务状态即可，无需传 callback_url。

content 元素

content 是一个数组，每个元素用 type 区分种类。下面是官方协议的写法，以官方规格为准，我们只实测过纯文本的 text 元素（见上面的参数表和快速开始）。

`type`	作用	关键字段
`text`	提示词	`text`
`image_url`	首帧、尾帧或参考图	`image_url.url`；`role` 取 `first_frame`、`last_frame`、`reference_image`
`video_url`	参考视频	`video_url.url`；`role` 取 `reference_video`
`audio_url`	参考音频	`audio_url.url`；`role` 取 `reference_audio`

使用素材时请留意：

首帧、首尾帧的用法，不能和参考图、参考视频、参考音频混在同一个请求里。
素材链接必须是公网可访问的 HTTPS 地址，不需要登录，并且在任务完成之前一直有效。
图片也可以用 Base64 的 data URL 传入。
参考素材直接用公网 HTTPS 链接传入，无需预先上传或入库。

各素材的数量与时长上限见模型与规格。

含参考视频的计费影响

以 Seedance 2.0 / 480p、输出 5 秒为例：不带参考视频，费用约 ¥1.98；带参考视频时，创建时的预扣约 ¥4.79（5 秒输出再加 15 秒预留）。实际结算取决于参考视频的实际时长，最多时与预留相当；参考视频累计超过 15 秒时还可能补扣。账户余额要够预扣这笔钱，否则创建会被拒绝（HTTP 403）。更多算例见价格与计费。

内容审核

含有真人肖像的参考图或参考视频，可能被内容审核拒绝，任务会以失败结束，已预扣的费用自动全额退回。遇到这种情况，换一份素材再试。以官方规格为准

请求示例

下面只展示 body，请求头与调用方式同快速开始。

文生视频，带组合参数

这个组合已在 Seedance 2.0 上实测：成片是竖屏、只有视频轨没有音轨，尾帧图无水印，结果里多出 content.last_frame_url。

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    { "type": "text", "text": "一只橘猫在窗台上伸懒腰，阳光透过窗帘" }
  ],
  "resolution": "480p",
  "duration": 4,
  "ratio": "9:16",
  "generate_audio": false,
  "return_last_frame": true,
  "watermark": false
}

首帧图生视频

以官方规格为准链接换成你自己的图片地址。

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    { "type": "text", "text": "镜头缓缓推近，人物转头微笑" },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/first-frame.png" },
      "role": "first_frame"
    }
  ],
  "resolution": "720p",
  "duration": 5
}

带参考视频

以官方规格为准链接换成你自己的视频地址。这类请求的计费规则见上面的「含参考视频的计费影响」。

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    { "type": "text", "text": "参考视频的运镜节奏，生成一段海边日落" },
    {
      "type": "video_url",
      "video_url": { "url": "https://example.com/reference.mp4" },
      "role": "reference_video"
    }
  ],
  "resolution": "720p",
  "duration": 5
}

创建成功后立刻返回任务号，此时 status 是 queued，视频还在排队：

{
  "content": {},
  "created_at": 1793358284,
  "id": "task_xxxxxxxx",
  "model": "doubao-seedance-2-0-260128",
  "status": "queued"
}

id：任务号，格式是 task_ 加 32 位字母和数字。务必保存，后面查询都靠它。
created_at：创建时间，Unix 时间戳（秒）。
返回里可能还会出现别的字段，不用处理，忽略即可。

拿到 id 之后，去查询任务与获取视频。