Seedance-1.5-pro（BytePlus 视频）

URL：/v3/contents/generations/tasks

Method：POST

请求体 · 顶层参数

参数	类型	必填	说明
model	string	是	视频生成模型 ID，如 Doubao-Seedance-1.5-pro
content	array	是	输入内容列表。每项为对象：文生视频可用 { "type": "text", "text": "描述文案" }；图生视频可包含 type: "image" 等
resolution	string	否	输出视频分辨率。可选 480p、720p、1080p、4k，默认 720p
ratio	string	否	输出视频宽高比。可选 16:9、4:3、1:1、3:4、9:16、21:9、adaptive。adaptive 会按输入自动确定比例（文生依 prompt、图生依首帧图）；图生比例不一致时可能居中裁剪
duration	integer	否	视频时长（秒），默认 5。与 frames 二选一（frames 优先）。常见范围 2~12；Seedance 1.5 Pro 可设 4~12，或设 -1 由模型在 4~12 内自动选择，实际值以任务查询结果为准
seed	integer	否	控制输出随机性的整数，默认 -1。取值范围 [-1, 2^32-1]。不传或 -1 时使用随机数；相同请求相同 seed 可得到相似但不一定完全相同的输出
callback_url	string	否	任务状态回调 URL。回调状态包括 queued、running、succeeded、failed、expired；回调请求体与「查询视频生成任务」响应体一致
return_last_frame	boolean	否	是否返回尾帧图片，默认 false。启用后可在任务查询结果中获取尾帧（PNG、与视频同尺寸），适用于多段视频衔接
execution_expires_after	integer	否	任务过期时间（秒），从 created_at 起算，默认 172800（48 小时），范围 [3600, 259200]。超时未完成会标记为 expired
camera_fixed	boolean	否	是否固定镜头，默认 false。图生场景通常不支持；开启后会在 prompt 侧附加固定镜头指令，但不保证实际效果
watermark	boolean	否	是否在输出视频中添加水印，默认 false。true：添加水印；false：不添加

响应字段（创建任务）

创建视频生成任务为异步接口。获取 id 后需通过「BytePlus 视频任务查询」轮询或回调获取状态，任务成功后可取得生成视频的 video_url。

参数	类型	必填	说明
id	string	—	视频生成任务 ID（通常保留 7 天）。可用于后续查询任务状态并拉取生成结果

cURL 示例

curl -X POST "$BASE_URL/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Doubao-Seedance-1.5-pro",
    "content": [
      { "type": "text", "text": "A panda riding a bicycle on a city street" }
    ],
    "resolution": "1080p",
    "duration": 5
  }'