seedance-2.0-kz / seedance-2.0-kz-fast

这一页只说明 MoonApiX 当前可用的 seedance-2.0-kz 系列模型：seedance-2.0-kz-fast 和 seedance-2.0-kz。如果你想要最完整的 Seedance 参数说明，优先看这一页。

兼容说明：旧模型名 seedance-2.0-fast 和 seedance-2.0 仍可提交，MoonApiX 会映射到这一组 KZ 公开模型；新系统请直接填写 seedance-2.0-kz-fast 或 seedance-2.0-kz。

包含模型

模型	说明
`seedance-2.0-kz-fast`	默认主推的快速版，适合高频生成。
`seedance-2.0-kz`	标准版，适合更高质量和 `1080P` 场景。

适合场景

默认快速生成

如果你只是想先跑通 Seedance 工作流，优先从 seedance-2.0-kz-fast 开始。

更高质量和 1080P

如果你明确需要 1080P，或者希望画面质量更稳，优先尝试 seedance-2.0-kz。

多模态参考

这一组适合同时使用参考图、参考视频和参考音频，也适合首尾帧控制。新接入复杂素材建议优先使用 references[]，再按模型能力映射到具体素材模式。

MoonApiX 当前明确支持

能力	支持情况
文生视频	支持
单图图生视频	支持
`references[]` 通用素材	支持
首尾帧	支持
多参考图	支持，最多 `9` 张
参考视频	支持，最多 `3` 个
参考音频	支持，最多 `3` 段
`Asset://` 素材引用	支持
`generate_audio`	支持
`watermark`	支持
`seed`	支持
`web_search`	支持
`super_resolution_config`	支持

ips 这类额外版权放行字段目前不在 MoonApiX 的公共文档承诺范围内。如果你确实需要，请先联系 MoonApiX 确认模型配置。

请求参数分栏

MoonApiX 统一通用视频参数

统一入口为 POST /v1/videos。客户端使用稳定的 prompt、references[]、aspect_ratio 和 size 字段，线路差异由服务端映射。

字段	类型	说明
`model`	string	`seedance-2.0-kz-fast` 或 `seedance-2.0-kz`。
`prompt`	string	视频描述；用 `@alias` 引用 `references[]` 素材。
`references[]`	array	通用素材数组，条目包含 `media_type`、`role`、`url` 和可选 `alias`。
`duration`	number	目标时长，按所选型号能力矩阵填写。
`aspect_ratio`	string	画面比例。
`size`	string	输出尺寸，例如 `720p` 或 `1080p`。
`generate_audio`	boolean	是否生成同步音频。
`watermark`	boolean	是否添加水印。
`seed`	integer	固定随机种子。
`callback_url`	string	可选的任务回调地址。

火山官方兼容参数

兼容入口为 POST /api/v3/contents/generations/tasks。请求体使用火山官方的 content[]、ratio 和 resolution 字段；同一请求不要同时提交 references[] 与 content[]。

字段	类型	说明
`model`	string	仍填写 MoonApiX 公共模型名。
`content[]`	array	官方多模态内容数组，文本条目使用 `type=text`，媒体条目使用 `image_url`、`video_url` 或 `audio_url`。
`duration`	number	官方时长字段。
`ratio`	string	官方画面比例字段。
`resolution`	string	官方输出分辨率字段。
`generate_audio`	boolean	官方音频生成开关。
`watermark`	boolean	官方水印开关。
`seed`	integer	官方随机种子。
`callback_url`	string	官方回调地址。

常用请求模式

seedance-2.0-kz-fast 和 seedance-2.0-kz 已覆盖 MoonApiX 通用素材写法。新接入复杂素材建议优先使用 references[]，每个条目包含 media_type、role、url 和可选 alias；images[] / videos[] / audios[]、image、reference_image_urls、first_frame_url、last_frame_url、audio_url 和 content[] 等字段继续兼容。

基础示例（MoonApiX 统一通用参数）

bash

curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-kz-fast",
    "prompt": "让 @hero 自然转身，镜头稳定推进，真实光照。",
    "references": [
      {
        "media_type": "image",
        "role": "reference_image",
        "url": "https://example.com/reference.png",
        "alias": "hero"
      }
    ],
    "duration": 5,
    "aspect_ratio": "16:9",
    "size": "720p"
  }'

基础示例（火山官方兼容参数）

bash

curl https://moonapix.com/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-kz-fast",
    "content": [
      { "type": "text", "text": "让 @hero 自然转身，镜头稳定推进，真实光照。" },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/reference.png" }, "alias": "hero" }
    ],
    "duration": 5,
    "ratio": "16:9",
    "resolution": "720p"
  }'

首尾帧示例

json

{
  "model": "seedance-2.0-kz-fast",
  "prompt": "镜头从人物正面推进到人物转身后的背影。",
  "images": [
    {
      "url": "https://example.com/first.png",
      "role": "first_frame"
    },
    {
      "url": "https://example.com/last.png",
      "role": "last_frame"
    }
  ],
  "duration": 5,
  "ratio": "16:9",
  "resolution": "720p"
}

对应的火山官方兼容写法：

json

{
  "model": "seedance-2.0-kz-fast",
  "content": [
    { "type": "text", "text": "镜头从人物正面推进到人物转身后的背影。" },
    { "type": "image_url", "role": "first_frame", "image_url": { "url": "https://example.com/first.png" }, "alias": "first" },
    { "type": "image_url", "role": "last_frame", "image_url": { "url": "https://example.com/last.png" }, "alias": "last" }
  ],
  "duration": 5,
  "ratio": "16:9",
  "resolution": "720p"
}

多图 + 多视频 + 多音频示例（MoonApiX 统一通用参数）

KZ 系列支持最多 9 张图片、3 个视频和 3 段音频。下面用较小的 2 + 2 + 2 组合演示统一 references[] 写法：

json

{
  "model": "seedance-2.0-kz-fast",
  "prompt": "保持 @hero1、@hero2 的角色一致，参考 @motion1、@motion2 的运镜，并混合 @audio1、@audio2 的背景声音。",
  "references": [
    { "media_type": "image", "role": "reference_image", "url": "https://example.com/hero-1.png", "alias": "hero1" },
    { "media_type": "image", "role": "reference_image", "url": "https://example.com/hero-2.png", "alias": "hero2" },
    { "media_type": "video", "role": "reference_video", "url": "https://example.com/motion-1.mp4", "alias": "motion1" },
    { "media_type": "video", "role": "reference_video", "url": "https://example.com/motion-2.mp4", "alias": "motion2" },
    { "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": 5,
  "aspect_ratio": "16:9",
  "size": "720p",
  "generate_audio": true
}

seedance-2.0-kz 也使用相同结构；请求超过单类或总数上限时会在创建前返回参数错误。

多图 + 多视频 + 多音频示例（火山官方兼容参数）

json

{
  "model": "seedance-2.0-kz-fast",
  "content": [
    { "type": "text", "text": "保持 @hero1、@hero2 的角色一致，参考 @motion1、@motion2 的运镜，并混合 @audio1、@audio2 的背景声音。" },
    { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/hero-1.png" }, "alias": "hero1" },
    { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/hero-2.png" }, "alias": "hero2" },
    { "type": "video_url", "role": "reference_video", "video_url": { "url": "https://example.com/motion-1.mp4" }, "alias": "motion1" },
    { "type": "video_url", "role": "reference_video", "video_url": { "url": "https://example.com/motion-2.mp4" }, "alias": "motion2" },
    { "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": 5,
  "ratio": "16:9",
  "resolution": "720p",
  "generate_audio": true
}

使用已上传素材

素材上传和审核通过后，请先查询素材详情，确认 generation_ready=true 且 preparation_status=ready。创建视频任务时仍需要在请求体里显式传入 Asset://asset_xxx；只设置 input_type: "reference" 不会自动加载素材。

参考图视频：

json

{
  "model": "seedance-2.0-kz-fast",
  "prompt": "图中女孩对着镜头说“茄子”，360度环绕运镜",
  "mode": "fast",
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": 5,
  "generate_audio": true,
  "watermark": false,
  "web_search": false,
  "input_type": "reference",
  "generation_type": "video",
  "content": [
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "Asset://asset_xxx"
      }
    }
  ]
}

首帧图生视频：

json

{
  "model": "seedance-2.0-kz-fast",
  "prompt": "图中女孩对着镜头说“茄子”，360度环绕运镜",
  "input_type": "reference",
  "first_frame_url": "Asset://asset_xxx",
  "duration": 5,
  "ratio": "adaptive",
  "resolution": "720p"
}

超分示例

json

{
  "model": "seedance-2.0-kz",
  "prompt": "城市夜景延时摄影，车流光轨清晰，画面稳定。",
  "duration": 5,
  "ratio": "16:9",
  "resolution": "1080p",
  "super_resolution_config": {
    "resolution": "4k",
    "scene": "aigc",
    "tool_version": "professional",
    "fps": 60
  }
}

其他兼容字段

以下字段属于历史或扩展兼容写法，不改变上面两栏的协议边界：

字段	所属协议	说明
`images[]` / `videos[]` / `audios[]`	MoonApiX 兼容	按媒体类型拆分的素材数组。
`image` / `image_url` / `video_url` / `audio_url`	MoonApiX 兼容	单媒体快捷字段。
`reference_image_urls` / `first_frame_url` / `last_frame_url`	MoonApiX 兼容	多参考图和首尾帧快捷字段。
`input_type`	MoonApiX 兼容	常用值为 `reference`、`first_last_frame`。
`web_search` / `super_resolution_config`	MoonApiX 扩展	联网增强和链式超分配置。

创建响应字段

创建任务成功后，请优先保存 MoonApiX 返回的 task_id 或 id，后续查询都使用这个任务 ID。

字段	类型	说明
`id`	string	MoonApiX 任务 ID。通常和 `task_id` 相同。
`task_id`	string	MoonApiX 任务 ID。推荐保存这个字段用于查询。
`data.task_id`	string	模型任务 ID。只用于辅助排查，不建议作为业务主键。
`status`	string	可选字段。创建响应里不一定出现，不要依赖它判断任务是否完成。
`message`	string	接口消息。为空字符串通常表示请求已受理。
`request_id`	string	请求 ID。排查问题时提供。
`trace_id`	string	跟踪 ID。排查问题时提供。
`metadata.request_id`	string	与本次请求相关的请求 ID。
`metadata.trace_id`	string	与本次请求相关的跟踪 ID。

创建响应里只出现 task_id、没有视频 URL，是正常情况。需要继续查询任务结果。

查询响应字段

查询任务时，不同阶段的字段会有差异。客户系统建议按字段是否存在来读取，不要假设每次响应都有完全相同的顶层字段。

字段	类型	说明
`id`	string	MoonApiX 任务 ID。
`task_id`	string	MoonApiX 任务 ID。
`status`	string	可选。任务状态；部分响应可能没有顶层 `status`。
`data.status`	string	可选。任务状态。顶层 `status` 不存在时，优先读取这个字段。
`data.error`	string	失败原因。`data.status=failed` 时优先读取。
`data.duration`	number	成片时长，单位秒。进行中通常为 `0`。
`data.usage`	object	计量信息。未完成或失败时可能为 `0`。
`url`	string	可选。最终视频 URL。
`video_url`	string	可选。最终视频 URL。
`result_url`	string	可选。最终视频 URL。
`output.url`	string	可选。最终视频 URL。
`metadata.url`	string	可选。最终视频 URL 或内容读取地址。
`data.video_url`	string	可选。最终视频 URL。完成时优先读取。
`request_id`	string	请求 ID。排查问题时提供。
`trace_id`	string	跟踪 ID。排查问题时提供。

状态判断

状态读取建议按这个顺序：

如果顶层 status 存在，优先读取顶层 status。
如果顶层 status 不存在，读取 data.status。
如果两个状态字段都不存在，但响应里只有 task_id，说明任务已创建，请继续轮询查询。
如果状态为 pending、submitted 或 running，继续查询。
如果状态为 succeeded，读取视频 URL 字段。
如果状态为 failed，读取 data.error，并保存 task_id、request_id、trace_id。

视频 URL 读取顺序

任务成功后，建议按这个顺序读取视频地址：

text

data.video_url
video_url
url
result_url
output.url
metadata.url

只要其中一个字段返回了可访问视频地址，就可以保存为最终结果。若地址为空，请继续查询同一个 task_id。

查询结果

建议在业务系统里保存 task_id、请求参数、最终视频 URL、request_id 和 trace_id。当响应没有顶层 status 时，按上面的状态读取顺序处理即可。

返回总览

Seedance-2 视频总览

对话协议

向量

音频

模型

GPT Image

Gemini Nano

Ideogram 图像

Midjourney 任务

Seedance-2 视频

Moon-2 视频

seedance-2.0-kz / seedance-2.0-kz-fast

包含模型

适合场景

默认快速生成

更高质量和 1080P

多模态参考

MoonApiX 当前明确支持

请求参数分栏

MoonApiX 统一通用视频参数

火山官方兼容参数

常用请求模式

基础示例（MoonApiX 统一通用参数）

基础示例（火山官方兼容参数）

首尾帧示例

多图 + 多视频 + 多音频示例（MoonApiX 统一通用参数）

多图 + 多视频 + 多音频示例（火山官方兼容参数）

使用已上传素材

超分示例

其他兼容字段

创建响应字段

查询响应字段

状态判断

视频 URL 读取顺序

查询结果

返回总览

Ideogram 图像

Midjourney 任务

Seedance-2 视频

Moon-2 视频

seedance-2.0-kz / seedance-2.0-kz-fast ​

包含模型 ​

适合场景 ​

默认快速生成 ​

更高质量和 1080P ​

多模态参考 ​

MoonApiX 当前明确支持 ​

请求参数分栏 ​

MoonApiX 统一通用视频参数 ​

火山官方兼容参数 ​

常用请求模式 ​

基础示例（MoonApiX 统一通用参数） ​

基础示例（火山官方兼容参数） ​

首尾帧示例 ​

多图 + 多视频 + 多音频示例（MoonApiX 统一通用参数） ​

多图 + 多视频 + 多音频示例（火山官方兼容参数） ​

使用已上传素材 ​

超分示例 ​

其他兼容字段 ​

创建响应字段 ​

查询响应字段 ​

状态判断 ​

视频 URL 读取顺序 ​

查询结果 ​

返回总览 ​

seedance-2.0-kz / seedance-2.0-kz-fast

包含模型

适合场景

默认快速生成

更高质量和 1080P

多模态参考

MoonApiX 当前明确支持

请求参数分栏

MoonApiX 统一通用视频参数

火山官方兼容参数

常用请求模式

基础示例（MoonApiX 统一通用参数）

基础示例（火山官方兼容参数）

首尾帧示例

多图 + 多视频 + 多音频示例（MoonApiX 统一通用参数）

多图 + 多视频 + 多音频示例（火山官方兼容参数）

使用已上传素材

超分示例

其他兼容字段

创建响应字段

查询响应字段

状态判断

视频 URL 读取顺序

查询结果

返回总览