MoonApiX Docs

Appearance

seedance-2.0-qm 系列 ​

seedance-2.0-qm 系列是 MoonApiX Seedance-2 的 720P 视频模型线。当前公开模型为 seedance-2.0-qm-720p，适合需要多图片、多视频、多音频组合参考的任务。创建任务时，model 固定填写 seedance-2.0-qm-720p。

当前配置 ​

项目说明
推荐入口POST /v1/videos
查询入口GET /v1/videos/{task_id} 或 GET /v1/tasks/{task_id}
推荐素材字段references[]
推荐素材来源先用 /v1/assets/uploads 创建 MoonApiX 素材，再在生成请求中使用 Asset://asset_xxx
输出720P

能力边界 ​

能力支持情况
文生视频支持
图片参考支持，最多 9 张
视频参考支持，最多 3 个
音频参考支持，最多 3 个
混合素材支持，最多 15 个素材
references[] 通用素材支持
Asset:// 素材引用推荐使用
独立音频素材不建议单独使用；通常应同时提供图片或视频参考

推荐流程 ​

复杂素材任务建议分两步：

  1. 调用 /v1/assets/uploads 上传或登记素材，拿到 MoonApiX 返回的 asset_id 和 asset_url。
  2. 调用 /v1/videos，在 references[] 中使用 Asset://asset_xxx。

这样可以让素材先完成可用性检查和模型准备，后续任务复用同一个 MoonApiX 素材 ID。不同模型可能需要不同的素材准备结果，用户侧仍然只使用 MoonApiX 的 asset_xxx / Asset://asset_xxx。

上传素材 ​

上传本地文件 ​

bash
curl https://moonapix.com/v1/assets/uploads \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -F "mode=asset" \
  -F "model=seedance-2.0-qm-720p" \
  -F "type=image" \
  -F "file=@reference.png"

使用公网 URL 登记素材 ​

bash
curl https://moonapix.com/v1/assets/uploads \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "asset",
    "model": "seedance-2.0-qm-720p",
    "type": "image",
    "url": "https://example.com/reference.png"
  }'

上传成功后，请保存返回的 asset_id 和 asset_url。创建视频时推荐使用 asset_url，形如：

text
Asset://asset_xxx

创建视频任务 ​

单图参考 ​

bash
curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-qm-720p",
    "prompt": "参考 @hero 的人物，生成一段自然走向镜头的写实视频。",
    "duration": 5,
    "ratio": "16:9",
    "resolution": "720P",
    "references": [
      {
        "media_type": "image",
        "role": "reference_image",
        "url": "Asset://asset_xxx",
        "alias": "hero"
      }
    ]
  }'

多素材组合 ​

json
{
  "model": "seedance-2.0-qm-720p",
  "prompt": "让 @角色 在 @场景 中完成动作，参考 @动作视频 的动作节奏，并使用 @旁白 的声音氛围。",
  "duration": 8,
  "ratio": "16:9",
  "resolution": "720P",
  "references": [
    {
      "media_type": "image",
      "role": "character_reference",
      "url": "Asset://asset_character",
      "alias": "角色"
    },
    {
      "media_type": "image",
      "role": "style_reference",
      "url": "Asset://asset_scene",
      "alias": "场景"
    },
    {
      "media_type": "video",
      "role": "reference_video",
      "url": "Asset://asset_motion",
      "alias": "动作视频"
    },
    {
      "media_type": "audio",
      "role": "reference_audio",
      "url": "Asset://asset_voice",
      "alias": "旁白"
    }
  ]
}

完整多素材任务最多可使用 9 张图片、3 个视频和 3 个音频。alias 不要带 @；提示词里用 @alias 绑定素材。

常用字段 ​

字段类型说明
modelstring固定填写 seedance-2.0-qm-720p。
promptstring视频描述。建议写清主体、动作、场景、镜头和素材绑定。
durationnumber/string视频时长。当前建议 4 到 15 秒。
ratio / aspect_ratiostring画面比例，例如 16:9、9:16、1:1。
resolutionstring建议填写 720P。
referencesarray推荐。通用素材引用数组。
references[].media_typestringimage、video、audio 或 music。
references[].rolestring常见值为 reference_image、character_reference、style_reference、reference_video、reference_audio、background_music。
references[].urlstring推荐使用 Asset://asset_xxx。
references[].aliasstring可选。提示词中的绑定名，例如 hero、角色、旁白。
callback_urlstring可选。任务完成后的回调地址。

查询结果 ​

创建响应只代表任务已提交，请保存 task_id 并继续查询：

bash
curl https://moonapix.com/v1/videos/{task_id} \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

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

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

请先判断 status 是否为 succeeded。如果任务还在 pending、submitted 或 running，继续轮询同一个 task_id。

注意事项 ​

  • 客户侧不要保存或传递模型服务返回的非 MoonApiX 素材标识；只使用 MoonApiX 返回的 asset_xxx / Asset://asset_xxx。
  • 公开视频结果会返回 MoonApiX 可访问的视频地址；不要依赖或解析非公开下载地址。
  • 多音频或多视频组合建议先逐个完成素材上传，再提交生成任务。
  • 若素材安全检查失败，请更换素材或重新上传。历史任务和已成功上传的素材可以继续查询和复用。

相关页面 ​