SD 云厂商版视频 API 规范

SD2.0 与 SD2.5 按分辨率计费的调用方式，以及时长、比例、参考素材、首尾帧和音频规则。

本页是 SD 云厂商版视频模型（SD2.0、SD2.5）的调用规范。它们与其他视频模型共用 POST /v1/videos 创建、GET /v1/videos/{id} 轮询的流程；鉴权、素材上传、轮询状态、结果下载和错误处理见视频 API 完整调用规范，本页只列出这组模型特有的字段和规则。

更新于 2026-10-10。本组模型只支持轮询：提交时不要设置 callback_url，否则请求会被拒绝。SD 云厂商版与 Seedance 官方版、Seedance 官转是不同的模型组，参数和能力不通用。

模型一览

模型	可选分辨率	时长	比例	图 / 视频 / 音频上限	首尾帧	生成音频
`SD2.5`	`480p`（默认）、`720p`、`1080p`	4–30 秒，默认 5 秒	必须指定，见下文	30 / 10 / 10	支持，与普通参考素材互斥	可用 `generate_audio` 设置
`SD2.0`	`480p`（默认）、`720p`、`1080p`、`4k`	4–15 秒，默认 5 秒	默认 `1:1`	9 / 3 / 3，三类合计最多 12	支持，与普通参考素材互斥	不可设置

每个系列只有一个模型名，用 resolution 选择输出档位并按该档位计费，例如 "model": "SD2.5", "resolution": "720p"、"model": "SD2.0", "resolution": "4k"。

通用规则

分辨率：resolution 填上表中的档位，大小写均可（4k 与 4K 等价）；不传时使用最低档 480p。填写该系列不支持的档位会返回 400，不会自动降档。
时长：duration（或字符串形式的 seconds）填整数秒；不传时为 5 秒。
比例：ratio（或 aspect_ratio）可选 16:9、9:16、1:1、4:3、3:4、21:9。
- SD2.5：必须明确指定比例，不支持 auto；不传或传 auto 会返回 400。
- SD2.0：不传时为 1:1。
提示词：
- SD2.5：prompt 必填。
- SD2.0：提供了参考素材或首尾帧时可以省略，但建议写明动作和镜头要求。
生成音频：SD2.5 支持 generate_audio（布尔值）；SD2.0 不支持该开关，发送会返回 400。
可选字段：negative_prompt（负面提示词）、seed（整数）。

参考素材

参考图片放顶层 images 数组。
参考视频放 metadata.referenceVideos，参考音频放 metadata.referenceAudios。
SD2.0 三类素材合计最多 12 个。
SD2.5 的单段参考视频为 2–30 秒，参考视频合计不超过 30 秒。
同一类素材只用一个字段提交；同时提交多个别名时只取其中一组，不会合并。

{
  "model": "SD2.5",
  "resolution": "1080p",
  "prompt": "保持参考图人物的面部和服装，按参考视频的运镜在雨夜街头奔跑",
  "duration": 10,
  "ratio": "9:16",
  "generate_audio": true,
  "images": ["https://cdn.example.com/character.jpg"],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/camera-motion.mp4"]
  }
}

首尾帧

首帧和尾帧放在 metadata.firstFrame 与 metadata.lastFrame。lastFrame 必须与 firstFrame 同时提供；首尾帧不能与参考图片、参考视频或参考音频混用。

{
  "model": "SD2.0",
  "resolution": "720p",
  "prompt": "镜头从清晨的海岸平滑推进到傍晚的同一海湾",
  "duration": 8,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

文件上传

也可以用 multipart/form-data 直接上传 1 个本地图片文件，字段名为 input_reference；此时不能再同时提交 images 或 image。参考视频和音频不能以文件形式提交，请先按本地素材上传取得 URL。

旧模型名

此前带档位后缀的模型名（如 SD2.5 720P、SD2.0 4K）仍可调用，输出和计费固定为名称中的档位，会忽略 resolution。它们已不在模型广场展示，新接入请使用 SD2.5、SD2.0 加 resolution。