1. 视频参数规则
GET
/docs/v2/video-models
1. 两类视频模型
| 类别 | 怎么判断 | 可用字段 |
|---|---|---|
| Seedance 系列 | 模型名含 seedance，例如 doubao-seedance-2.0-720p、doubao-seedance-2.0-fast、doubao-seedance-2.0-mini-480p、doubao-seedance-2.0-480p-特价 | 全部字段：prompt、seconds、size 或 aspect_ratio + resolution、input_reference（首帧）、last_frame（尾帧）、reference_images、reference_videos、reference_audios、generate_audio、watermark、seed |
| 其他视频模型 | 模型名不含 seedance 的视频模型，例如 sora、veo、grok | prompt、seconds、size 或 aspect_ratio + resolution、input_reference、reference_images、reference_videos（最多 1 个）。尾帧、参考音频与声音 / 水印 / 种子开关只用于 Seedance 系列，传了返回 400 unsupported_parameter |
2. Seedance 系列的取值与默认 值
| 字段 | 取值 | 不传时 |
|---|---|---|
| seconds | 整数秒。平台只检查 1–3600，具体范围由模型服务校验（Seedance 2.0 为 4–15，mini 为 4–11） | 5 |
| resolution | 480p、720p、1080p，大小写均可。模型名带 -480p / -720p / -1080p 的已由模型名固定，传了不一致的值返回 400 | 模型名带档位的用该档位；不带档位的为 720p，传了 size 时按像素量换算 |
| aspect_ratio | 16:9、9:16、1:1、4:3、3:4、21:9、adaptive、keep_ratio | 有首帧或参考素材时为 adaptive，否则为 16:9 |
| size | 宽x高，按最接近的宽高比换算；模型名带档位的，档位仍以模型名为准（例如 doubao-seedance-2.0-480p 收到 1280x720，按 480p、16:9 输出 864x496） | — |
| generate_audio、watermark、seed | 传了才发给模型服务 | 由模型服务决定（Seedance 2.0 默认生成声音、不加水印、随机种子） |
3. size 与清晰 度、宽高比的对应
| resolution | 16:9 | 4:3 | 1:1 | 3:4 | 9:16 | 21:9 |
|---|---|---|---|---|---|---|
| 480p | 864x496 | 752x560 | 640x640 | 560x752 | 496x864 | 992x432 |
| 720p | 1280x720 | 1112x834 | 960x960 | 834x1112 | 720x1280 | 1470x630 |
| 1080p | 1920x1080 | 1664x1248 | 1440x1440 | 1248x1664 | 1080x1920 | 2206x946 |
4. 参考素材（Seedance 系列）
| 素材 | 平台限制 | 模型服务要求（Seedance 2.0） |
|---|---|---|
| 首帧、尾帧、参考图 | 参考图最多 9 张；单张 ≤ 30MB | jpg / png / webp；宽高比 0.4–2.5 |
| 参考视频 | 最多 3 个；单个 ≤ 50MB | 单个 2–15 秒，合计 ≤ 15 秒；mp4 / mov，H.264 / H.265，24–60 FPS；宽和高均在 300–6000 像素之间，宽高比 0.4–2.5；总像素在 640×640 到 2206×946 之间 |
| 参考音频 | 最多 3 个；单个 ≤ 15MB | 单个 2–15 秒，合计 ≤ 15 秒；必须和参考图或参考视频一起使用 |
last_frame 必须和 input_reference 一起传。首帧 / 首尾帧与参考素材能否在同一个请求里混用、参考音频的搭配等由模型服务校验（Seedance 2.0 不支持混用），不符合时返回 upstream_rejected 并附原因。reference_videos，在提示词里说明要怎么用，例如「把视频1里的人物换成图片1里的人物」「接着视频1继续往后拍」。unsupported_parameter（去掉后重发即可），素材不是公网链接且平台未开通转存时返回 400 invalid_media，都不扣费。upstream_rejected，或任务失败（generation_failed），原因见 message。5. 其他视频模型
size + input_reference，有的用 aspect_ratio + resolution + images），平台会同时带上 OpenAI 写法和常见的扩展写法；模型服务只认其中一种、拒收其余写法时，平台自动去掉它不认识的写法重发并记住，调用方不用按模型调整（被拒的那几次不建任务、不扣费）。size 与 aspect_ratio / resolution 会互相换算：传了 size 时同时给出比例和清晰度；只传比例或只传清晰度时，按 16:9 / 720p 补出 size 给只认 size 的模型。查询结果里的 size、resolution、aspect_ratio 只在传了或能换算时有值，否则为 null。resolution 原样发给模型服务（如 480p、720P，大小写以模型要求为准）；时长、尺寸、清晰度的可选值都由模型服务校验，不支持时返回 upstream_rejected 并附原因；不传时使用模型服务的默认值。input_reference 是要动起来的图（首帧），reference_images 是参考图；多张图片怎么用由模型服务决定（例如有的模型把两张图当首尾帧）。reference_videos 用于视频延伸、视频编辑这类需要输入视频的模型（例如 grok-imagine-video 必须带参考视频），最多 1 个。请求参数
无
请求示例代码
返回响应
修改于 2026-10-10 05:00:27