Seedance 视频指南
Seedance-2 提供 SH、SG、NT、SZ、原生、KZ、CL、CL-B 和 GL 九个独立系列。新接入先确定系列，再从该系列页面列出的公开模型名中选择；不同系列的参数和素材准备流程不要混用。
SH 系列包含 seedance-2.0-sh、seedance-2.0-sh-fast、seedance-2.0-sh-mini 和 seedance-2.5-sh，支持 /v1/videos 通用参数及 /api/v3/contents/generations/tasks 官方兼容参数。2.0 支持 4 - 15 秒，2.5 支持 4 - 30 秒；支持 duration=-1 自动时长。显式参数按顶层、input、metadata 的顺序取值，顶层 generate_audio=false 不会被较低优先级的 true 覆盖。各型号分辨率、素材上限和认证限制以 SH 页面为准。
SG 系列包含 seedance-2.0-sg-mini、seedance-2.0-sg、seedance-2.0-sg-fast 和 seedance-2.5-sg，支持通用与官方兼容参数。四个型号均已验证单图参考与 4 秒生成；标准版支持 480P / 720P / 1080P / 4K，Fast/Mini 支持 480P / 720P，2.5 支持 480P / 720P / 1080P，按输出 Token 结算。
其中 SZ 系列的四个公共模型、seedance-2.5-cl，以及 CL-B 系列的两个公共模型，都兼容火山引擎官方形状的 content[]、ratio、resolution、 duration 和 generate_audio 等字段。需要保留火山引擎官方路径时使用 /api/v3/contents/generations/tasks，但 model 仍填写 MoonApiX 公共模型 ID，例如 seedance-2.0-sz、seedance-2.5-sz、seedance-2.5-cl 或 seedance-2.0-cl-b-fast。两种入口都使用 MoonApiX API Key，model 仍按本页 公共模型列表填写。
seedance-2.5-cl 推荐使用 /v1/videos 和 references[]，也支持官方形状的 content[]。字段对应关系、完整示例和认证素材规则见 seedance-2.5-cl 官方兼容参数；这不代表官方所有高级参数都可用，具体能力以模型页为准。
CL-B 的参数和能力与火山引擎 Seedance 2.0 Fast / Mini 官方契约对齐。媒体条目建议显式提供唯一 alias；字段取值、素材数量和模型边界请按 CL-B 系列页面 及所选官方型号能力矩阵执行。
快速选择
| 需求 | 推荐模型 | 说明 |
|---|---|---|
| SH 通用或官方兼容视频参数 | seedance-2.0-sh、seedance-2.0-sh-fast、seedance-2.0-sh-mini、seedance-2.5-sh | 2.0 最多 9 图 + 3 视频 + 3 音频，2.5 最多 30 图 + 10 视频 + 10 音频；2.5 严格首帧使用 adaptive。已验证 2.5 文生视频 1080P / 4 秒，视频认证成功尚未验证；见 SH 系列。 |
| NT 参考素材与 Token 结算 | seedance-2.0-nt、seedance-2.0-nt-fast、seedance-2.0-nt-mini、seedance-2.5-nt | 四个型号已验证单张公网参考图、4 秒和 16:9；2.0 Mini 支持 4 - 15 秒，2.5 严格首帧保持输入比例。见 NT 系列。 2.0 标准版和 2.5 另支持 1080P 混合参考；Fast/Mini 为 720P。 |
| 官方 Token 用量计费的多模态视频和视频参考 | seedance-2.0-sz、seedance-2.0-sz-fast、seedance-2.0-sz-mini、seedance-2.5-sz | SZ 系列统一使用 references[]；2.0 系列支持 4 - 15 秒，2.5 支持 4 - 30 秒。包含视频参考时按官方视频输入计费维度处理。 |
| 火山公开原生模型 | doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615 | 原生系列的标准、Fast、Mini 三个模型，具体参数和素材流程见独立页面。 |
| 默认快速生成 | seedance-2.0-kz-fast | 适合高频、批量和默认快速出片。 |
公网 URL 或本模型线 Asset:// 图生视频 / 视频参考 | seedance-2.0-cl-fast 或 seedance-2.0-cl | 标准兼容线路，适合单图图生视频和带参考视频的任务；视频参考建议先创建本模型线素材 ID，素材 ID 不要和 seedance-2.0-kz 系列跨线混用。 |
| Seedance 2.5 多模态和认证素材 | seedance-2.5-cl | 支持 4 - 30 秒、480P / 720P / 1080P、最多 50 个混合参考素材；Asset:// 必须按本模型准备并保持 ready，解析失败直接报错。 |
| 轻量 480P / 720P CL 工作流 | seedance-2.0-cl-mini | 参数体系与 CL 系列一致，支持文生视频、图生视频、视频参考和本模型线 Asset:// 素材引用，时长 4 - 15 秒。 |
| 火山官方形状兼容的 CL-B 混合素材 | seedance-2.0-cl-b-fast、seedance-2.0-cl-b-mini | 使用 /api/v3/contents/generations/tasks 和官方 content[]；参数、比例、分辨率、时长和素材边界与所选官方 Fast / Mini 型号契约一致。 |
| 多素材混合参考 | seedance-2.0-gl、seedance-2.0-gl-fast、seedance-2.0-gl-mini | 支持最多 9 图 + 3 视频 + 3 音频，合计最多 15 个素材，时长 4 - 15 秒；标准版支持到 1080P，Fast/Mini 支持 480P / 720P。 |
| 更高画质或 1080P | seedance-2.0-kz | 适合更高质量和 1080P 场景。 |
两套请求协议
NT 系列也支持 /api/v3/contents/generations/tasks 和官方形状的 content[]、ratio、resolution、duration、generate_audio、watermark；仍使用 NT 公开模型名和 MoonApiX API Key。NT 的单图示例、时长边界与认证素材限制见 NT 官方兼容参数，查询结果使用轮询。
MoonApiX 对外提供两套等价的 Seedance 请求表达。每次请求选择其中一套即可，不要同时传入 references[] 和 content[]，也不要同时重复传入 prompt 与 content[].text。
MoonApiX 统一通用视频参数
统一入口使用 POST /v1/videos：
| 参数 | 说明 |
|---|---|
model | MoonApiX 公共模型名。 |
prompt | 视频描述，可用 @alias 引用素材。 |
references[] | 统一素材数组，条目使用 media_type、role、url、alias。 |
duration | 目标时长。 |
aspect_ratio | 画面比例。 |
size | 输出尺寸。 |
generate_audio、watermark、seed、callback_url | 通用控制字段。 |
火山官方兼容参数
官方形状参数可以提交到 POST /v1/videos，也可以使用兼容入口 POST /api/v3/contents/generations/tasks：
| 参数 | 说明 |
|---|---|
model | 仍填写 MoonApiX 公共模型名。 |
content[] | 官方文本和媒体条目数组。 |
duration | 官方时长字段。 |
ratio | 官方比例字段。 |
resolution | 官方分辨率字段。 |
generate_audio、watermark、seed、callback_url | 官方控制字段。 |
通用素材引用
新接入复杂素材优先使用 references[]，每个条目用 media_type 标明图片、视频、音频或音乐，用 role 标明用途，用 alias 给素材取可在提示词中引用的别名。images[] / videos[] / audios[] 和 content[] 继续作为兼容写法。
{
"model": "seedance-2.0-kz-fast",
"prompt": "让人物自然转身，镜头稳定推进。",
"references": [
{
"media_type": "image",
"role": "reference_image",
"url": "https://example.com/reference.png",
"alias": "hero"
}
],
"duration": 14,
"ratio": "16:9"
}多素材组合时，可以在同一个 references[] 中放入多张图片、多个视频和多段音频。下面是跨系列通用的 2 图 + 2 视频 + 2 音频示例；是否可用以及单类/总数上限，以所选模型详情页为准：
{
"model": "seedance-2.0-gl",
"prompt": "保持 @image1、@image2 的主体特征，参考 @video1、@video2 的动作，并融合 @audio1、@audio2。",
"references": [
{ "media_type": "image", "role": "reference_image", "url": "https://example.com/image-1.png", "alias": "image1" },
{ "media_type": "image", "role": "reference_image", "url": "https://example.com/image-2.png", "alias": "image2" },
{ "media_type": "video", "role": "reference_video", "url": "https://example.com/video-1.mp4", "alias": "video1" },
{ "media_type": "video", "role": "reference_video", "url": "https://example.com/video-2.mp4", "alias": "video2" },
{ "media_type": "audio", "role": "reference_audio", "url": "https://example.com/audio-1.mp3", "alias": "audio1" },
{ "media_type": "audio", "role": "reference_audio", "url": "https://example.com/audio-2.mp3", "alias": "audio2" }
],
"duration": 8,
"ratio": "16:9",
"resolution": "720P",
"generate_audio": true
}所有火山官方 Seedance 系列都可以沿用这份多图、多视频、多音频结构示例；不同型号的数量、时长、分辨率和角色细节由对应模型能力配置校验，客户端无需改写素材数组结构。
对应的火山官方兼容写法如下（字段语义相同，仅请求入口和素材容器不同）：
{
"model": "seedance-2.0-gl",
"content": [
{ "type": "text", "text": "保持 @image1、@image2 的主体特征，参考 @video1、@video2 的动作，并融合 @audio1、@audio2。" },
{ "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/image-1.png" }, "alias": "image1" },
{ "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/image-2.png" }, "alias": "image2" },
{ "type": "video_url", "role": "reference_video", "video_url": { "url": "https://example.com/video-1.mp4" }, "alias": "video1" },
{ "type": "video_url", "role": "reference_video", "video_url": { "url": "https://example.com/video-2.mp4" }, "alias": "video2" },
{ "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/audio-1.mp3" }, "alias": "audio1" },
{ "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/audio-2.mp3" }, "alias": "audio2" }
],
"duration": 8,
"ratio": "16:9",
"resolution": "720P",
"generate_audio": true
}素材上传
- 已有稳定公网 URL 时，直接在视频请求里传 URL。
- 联调本地文件时，可用
/v1/assets/uploads的mode=oss创建临时测试 URL；正式业务请使用客户自有存储的稳定公网 URL。 - 只有模型页面明确支持素材引用时，才使用
Asset://asset_xxx。 - 对
seedance-2.0-cl/seedance-2.0-cl-fast/seedance-2.0-cl-mini，图片参考可以直接传稳定公网 URL；视频参考建议先用/v1/assets/uploads创建type=video、role=reference_video的Asset://asset_xxx，再传给video_url或references[].url。 - 对
seedance-2.0-gl/seedance-2.0-gl-fast/seedance-2.0-gl-mini，客户自己的稳定公网 URL 优先；需要复用素材时按目标 GL 模型创建Asset://asset_xxx，音频参考必须与图片或视频一起提交。
curl https://moonapix.com/v1/assets/uploads \
-H "Authorization: Bearer <MOONAPIX_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0-cl",
"mode": "asset",
"type": "video",
"purpose": "reference_video",
"role": "reference_video",
"url": "https://example.com/reference.mp4"
}'{
"model": "seedance-2.0-cl",
"prompt": "保留参考视频中的动作，把上衣图案替换为参考图片风格。",
"video_url": "Asset://asset_video_xxx",
"image_url": "https://example.com/reference-shirt.png",
"duration": 5
}相关页面
- Seedance-2 视频总览
- seedance-2.0-nt / seedance-2.5-nt 系列
- seedance-2.0-sz / seedance-2.5-sz 系列
- seedance-2.0 原生系列
- seedance-2.0-kz / seedance-2.0-kz-fast
- seedance-2.0-cl / seedance-2.0-cl-fast / seedance-2.0-cl-mini
- seedance-2.5-cl
- seedance-2.0-cl-b-fast / seedance-2.0-cl-b-mini
- seedance-2.0-gl / seedance-2.0-gl-fast / seedance-2.0-gl-mini
- Moon-2 视频总览