Dreamina-Seedance-2.0-fast · 生成视频

接口	方法	路径
提交任务	POST	/v1/videos/generations
查询结果	GET	/v1/videos/generations/{id}

请求参数

Authorization

在 Header 添加参数 Authorization，其值为 Bearer 之后拼接你的 API Key。

Authorization: Bearer ****************

Header 参数

Content-Typestring可选

application/json

Acceptstring可选

application/json

Body 参数application/json必填

modelstring必需

模型 ID，固定为 `dreamina-seedance-2-0-fast-260128`

contentarray[object]必需

BytePlus 原生输入数组（推荐主用法），下方 5 种 type 组合使用。注意 role 跟 type 同级放在 content item 外层，不进 image_url/video_url 子对象。role 取值：图片 first_frame/last_frame/reference_image；视频 reference_video。

callback_urlstring可选

任务状态变更时的回调通知地址（可选）

return_last_frameboolean可选

是否返回视频尾帧图（默认 false）

resolutionstring可选

480p / 720p / 1080p / 4k视频分辨率（默认 720p；4k 仅 Seedance 2.0）

ratiostring可选

16:9 / 4:3 / 1:1 / 9:16 / 21:9 / adaptive生成视频宽高比（默认 adaptive）

durationinteger可选

视频时长（秒），默认 5

seedinteger可选

随机种子，默认 -1（随机）；范围 [-1, 2^32-1]

camera_fixedboolean可选

是否固定镜头（默认 false）

watermarkboolean可选

是否添加水印（默认 false）

service_tierstring可选

default / flex服务档位：default 在线推理 / flex 离线推理（半价，Seedance 2.0 系列不支持）

execution_expires_afterinteger可选

任务超时阈值（秒），自创建时间起算；默认 172800（48h），范围 [3600, 259200]

generate_audioboolean可选

生成视频是否含同步音频（默认 true；仅 Seedance 2.0 系列 / 1.5 Pro）

draftboolean可选

是否开启草稿模式（默认 false；仅 Seedance 1.5 Pro；草稿固定 480p）

safety_identifierstring可选

终端用户唯一标识，用于平台风控识别

示例

{  "model": "dreamina-seedance-2-0-fast-260128",  "content": [    {      "type": "text",      "text": "海浪拍打礁石的慢镜头，黄昏暖色调"    }  ],  "resolution": "720p",  "ratio": "16:9",  "duration": 5,  "seed": 11,  "camera_fixed": false,  "watermark": false}

请求示例代码

curl https://api.hotrouter.ai/v1/videos/generations \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "dreamina-seedance-2-0-fast-260128",    "content": [      {        "type": "text",        "text": "海浪拍打礁石的慢镜头，黄昏暖色调"      }    ],    "resolution": "720p",    "ratio": "16:9",    "duration": 5,    "seed": 11,    "camera_fixed": false,    "watermark": false  }'

返回响应

提交任务

{  "id": "vid_xxxx",  "object": "video.generation.job",  "status": "queued"}

查询结果

{  "id": "vid_xxxx",  "status": "completed",  "data": [    {      "url": "https://.../video.mp4"    }  ]}

接口	方法	路径
提交任务	POST	/v1/videos/generations
查询结果	GET	/v1/videos/generations/{id}

请求参数

Authorization

在 Header 添加参数 Authorization，其值为 Bearer 之后拼接你的 API Key。

Authorization: Bearer ****************

Header 参数

Content-Typestring可选

application/json

Acceptstring可选

application/json

Body 参数application/json必填

modelstring必需

模型 ID，固定为 `dreamina-seedance-2-0-fast-260128`

contentarray[object]必需

callback_urlstring可选

任务状态变更时的回调通知地址（可选）

return_last_frameboolean可选

是否返回视频尾帧图（默认 false）

resolutionstring可选

480p / 720p / 1080p / 4k视频分辨率（默认 720p；4k 仅 Seedance 2.0）

ratiostring可选

16:9 / 4:3 / 1:1 / 9:16 / 21:9 / adaptive生成视频宽高比（默认 adaptive）

durationinteger可选

视频时长（秒），默认 5

seedinteger可选

随机种子，默认 -1（随机）；范围 [-1, 2^32-1]

camera_fixedboolean可选

是否固定镜头（默认 false）

watermarkboolean可选

是否添加水印（默认 false）

service_tierstring可选

default / flex服务档位：default 在线推理 / flex 离线推理（半价，Seedance 2.0 系列不支持）

execution_expires_afterinteger可选

任务超时阈值（秒），自创建时间起算；默认 172800（48h），范围 [3600, 259200]

generate_audioboolean可选

生成视频是否含同步音频（默认 true；仅 Seedance 2.0 系列 / 1.5 Pro）

draftboolean可选

是否开启草稿模式（默认 false；仅 Seedance 1.5 Pro；草稿固定 480p）

safety_identifierstring可选

终端用户唯一标识，用于平台风控识别

示例

{
  "model": "dreamina-seedance-2-0-fast-260128",
  "content": [
    {
      "type": "text",
      "text": "海浪拍打礁石的慢镜头，黄昏暖色调"
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "seed": 11,
  "camera_fixed": false,
  "watermark": false
}

{  "model": "dreamina-seedance-2-0-fast-260128",  "content": [    {      "type": "text",      "text": "海浪拍打礁石的慢镜头，黄昏暖色调"    }  ],  "resolution": "720p",  "ratio": "16:9",  "duration": 5,  "seed": 11,  "camera_fixed": false,  "watermark": false}

请求示例代码

curl https://api.hotrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-fast-260128",
    "content": [
      {
        "type": "text",
        "text": "海浪拍打礁石的慢镜头，黄昏暖色调"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "seed": 11,
    "camera_fixed": false,
    "watermark": false
  }'

curl https://api.hotrouter.ai/v1/videos/generations \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "dreamina-seedance-2-0-fast-260128",    "content": [      {        "type": "text",        "text": "海浪拍打礁石的慢镜头，黄昏暖色调"      }    ],    "resolution": "720p",    "ratio": "16:9",    "duration": 5,    "seed": 11,    "camera_fixed": false,    "watermark": false  }'

返回响应

提交任务

{
  "id": "vid_xxxx",
  "object": "video.generation.job",
  "status": "queued"
}

{  "id": "vid_xxxx",  "object": "video.generation.job",  "status": "queued"}

查询结果

{
  "id": "vid_xxxx",
  "status": "completed",
  "data": [
    {
      "url": "https://.../video.mp4"
    }
  ]
}

{  "id": "vid_xxxx",  "status": "completed",  "data": [    {      "url": "https://.../video.mp4"    }  ]}

Dreamina-Seedance-2.0-fast · 生成视频

请求参数

请求示例代码

返回响应

On this page

Dreamina-Seedance-2.0-fast · 生成视频

请求参数

请求示例代码

返回响应

On this page