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 确认模型配置。

常用请求模式

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[] 等字段继续兼容。

基础示例

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,
    "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"
}

使用已上传素材

素材上传和审核通过后，请先查询素材详情，确认 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
  }
}

常用字段

输入字段

字段	说明
`references[]`	推荐。通用素材引用数组，条目包含 `media_type`、`role`、`url` 和可选 `alias`。
`images[]`	兼容。图片素材数组，常见 `role` 为 `reference_image`、`first_frame`、`last_frame`。
`videos[]`	兼容。参考视频数组，常见 `role` 为 `reference_video`。
`audios[]`	兼容。参考音频数组，常见 `role` 为 `reference_audio`。
`image` / `image_url`	兼容字段。单张参考图或首帧图。
`reference_image_urls`	兼容字段。多参考图。
`first_frame_url` / `last_frame_url`	兼容字段。首尾帧模式。
`video` / `video_url`	兼容字段。参考视频。
`audio` / `audio_url`	兼容字段。参考音频。
`content[]`	兼容字段。多模态组合输入。
`input_type`	常用值为 `reference`、`first_last_frame`。

控制字段

字段	说明
`duration`	视频时长。
`ratio` / `aspect_ratio`	画面比例。
`resolution`	输出分辨率。
`generate_audio`	是否生成同步音频。
`watermark`	是否添加模型侧水印。
`seed`	固定随机种子。
`web_search`	联网增强。
`super_resolution_config`	链式超分。
`callback_url`	完成后回调地址。

创建响应字段

创建任务成功后，请优先保存 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 视频总览

对话协议

向量

音频

模型

Ideogram 图像

Midjourney 任务

Seedance-2 视频

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

包含模型

适合场景

默认快速生成

更高质量和 1080P

多模态参考

MoonApiX 当前明确支持

常用请求模式

基础示例

首尾帧示例

使用已上传素材

超分示例

常用字段

输入字段

控制字段

创建响应字段

查询响应字段

状态判断

视频 URL 读取顺序

查询结果

返回总览

Ideogram 图像

Midjourney 任务

Seedance-2 视频

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

包含模型 ​

适合场景 ​

默认快速生成 ​

更高质量和 1080P ​

多模态参考 ​

MoonApiX 当前明确支持 ​

常用请求模式 ​

基础示例 ​

首尾帧示例 ​

使用已上传素材 ​

超分示例 ​

常用字段 ​

输入字段 ​

控制字段 ​

创建响应字段 ​

查询响应字段 ​

状态判断 ​

视频 URL 读取顺序 ​

查询结果 ​

返回总览 ​

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

包含模型

适合场景

默认快速生成

更高质量和 1080P

多模态参考

MoonApiX 当前明确支持

常用请求模式

基础示例

首尾帧示例

使用已上传素材

超分示例

常用字段

输入字段

控制字段

创建响应字段

查询响应字段

状态判断

视频 URL 读取顺序

查询结果

返回总览