MoonApiX Docs

Appearance

seedance-2.0-wc 系列 ​

seedance-2.0-wc 系列是 MoonApiX Seedance-2 的 720P 多素材视频模型线。当前公开模型为 seedance-2.0-wc-720p，适合需要在同一个任务中组合多张图片、多个视频和多段音频参考的生成场景。

创建任务时，model 固定填写 seedance-2.0-wc-720p。

当前配置 ​

项目说明
推荐入口POST /v1/videos
查询入口GET /v1/videos/{task_id} 或 GET /v1/tasks/{task_id}
推荐素材字段references[]
推荐素材来源稳定公网 URL；本地文件可先用 /v1/assets/uploads 的 mode=oss 获取 MoonApiX 托管公网 URL
输出720P
Prompt 长度最多 1000 个字符；超过限制会在提交阶段被拒绝
计费方式按次计费；实际价格以 MoonApiX 后台价格页和模型列表接口为准

能力边界 ​

能力支持情况
文生视频支持
图片参考支持，最多 9 张
视频参考支持，最多 3 个
音频参考支持，最多 3 个
混合素材支持，最多 15 个素材
references[] 通用素材支持
Asset:// 素材引用不作为当前 WC 系列输入路径；请传公网 URL
Prompt 长度最多 1000 个字符
独立音频素材不建议单独使用；通常应同时提供图片或视频参考

推荐流程 ​

复杂素材任务建议按公网 URL 组织：

  1. 准备可由 MoonApiX 访问的图片、视频和音频公网 URL。
  2. 如果素材在本地或原始 URL 不稳定，先调用 /v1/assets/uploads，使用 mode=oss 获取 MoonApiX 托管公网 URL。
  3. 调用 /v1/videos，在 references[] 中把公网 URL 写入 url。

WC 系列当前面向公网 URL 参考素材接入。不要把 Asset://asset_xxx 作为 WC 任务的主要输入格式。prompt 请控制在 1000 个字符以内；如果超过限制，任务会在提交阶段返回参数校验错误，不会进入生成队列。

准备公网 URL ​

本地文件转 MoonApiX 托管 URL ​

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

上传成功后，把返回的公网 url / public_url 填入视频任务的 references[].url。

已有公网 URL ​

bash
curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-wc-720p",
    "prompt": "参考 @hero 的人物，在自己的房间里跳一段可爱的舞蹈。",
    "duration": 15,
    "ratio": "9:16",
    "resolution": "720p",
    "references": [
      {
        "media_type": "image",
        "role": "reference_image",
        "url": "https://example.com/reference.png",
        "alias": "hero"
      }
    ]
  }'

创建视频任务 ​

单图参考 ​

bash
curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-wc-720p",
    "prompt": "参考 @hero 的人物，在自己的房间里跳一段可爱的舞蹈。",
    "duration": 15,
    "ratio": "9:16",
    "resolution": "720p",
    "references": [
      {
        "media_type": "image",
        "role": "reference_image",
        "url": "https://example.com/reference.png",
        "alias": "hero"
      }
    ]
  }'

多素材组合 ​

json
{
  "model": "seedance-2.0-wc-720p",
  "prompt": "让 @角色 在自己的房间里跳可爱的舞蹈，参考 @动作视频 的动作节奏，并跟随 @音乐 的轻快氛围。",
  "duration": 15,
  "ratio": "9:16",
  "resolution": "720p",
  "references": [
    {
      "media_type": "image",
      "role": "character_reference",
      "url": "https://example.com/character.png",
      "alias": "角色"
    },
    {
      "media_type": "video",
      "role": "reference_video",
      "url": "https://example.com/motion.mp4",
      "alias": "动作视频"
    },
    {
      "media_type": "audio",
      "role": "reference_audio",
      "url": "https://example.com/music.mp3",
      "alias": "音乐"
    }
  ]
}

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

常用字段 ​

字段类型说明
modelstring固定填写 seedance-2.0-wc-720p。
promptstring视频描述。最多 1000 个字符；建议写清主体、动作、场景、镜头和素材绑定。
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公网 URL 或 MoonApiX 托管公网 URL。
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。

注意事项 ​

  • WC 系列当前使用公网 URL 参考素材；不要把 Asset://asset_xxx 作为 WC 任务输入。
  • prompt 最多 1000 个字符。过长提示词会在提交阶段被拒绝，通常不会生成可轮询的任务。
  • 公开视频结果会返回 MoonApiX 可访问的视频地址；不要依赖或解析非公开下载地址。
  • 多音频或多视频组合建议先逐个确认 URL 可公开访问，再提交生成任务。
  • 若素材安全检查失败或 URL 无法访问，请更换素材 URL，或先用 mode=oss 上传为 MoonApiX 托管公网 URL。

相关页面 ​