Seedance
Seedance 2.5 · 生成视频
视频 / Seedance / Seedance 2.5 / 生成视频
| 接口 | 方法 | 路径 |
|---|---|---|
| 提交任务 | 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.5`
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.5", "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.5", "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" } ]}