MoonApiX Docs

Appearance

seedance-2.0-ld 系列 ​

seedance-2.0-ld 系列是 MoonApiX Seedance-2 的按次视频模型线。当前公开型号为 seedance-2.0-ld-17，适合文生视频、单图参考、首帧图生视频、多视觉参考和轻量音频参考任务。创建任务时，model 固定填写具体型号，例如 seedance-2.0-ld-17。

音频参考需要与图片或视频参考一起使用；不要只提交音频素材，否则任务可能被拒绝。

当前配置 ​

项目说明
当前型号seedance-2.0-ld-17
推荐入口POST /v1/videos
查询入口GET /v1/videos/{task_id} 或 GET /v1/tasks/{task_id}
推荐素材字段references[]
兼容字段image、image_url、images[]、videos[]、audios[]、reference_image_url(s)、first_frame_url、reference_video_url、content[]

能力边界 ​

能力支持情况
文生视频支持
单图参考支持
首帧图生视频支持
多视觉参考支持，建议图片最多 9 个、视频最多 3 个
独立音频参考支持，建议最多 3 个；需要与图片或视频参考一起使用，不要只传音频
MoonApiX 托管 URL支持，先通过 /v1/assets/uploads 使用 mode=oss 创建
Asset:// 素材引用不作为当前主路径；优先使用公网 URL 或 MoonApiX 托管 URL

推荐写法：references[] ​

新接入复杂素材建议优先使用 references[]。alias 可作为素材别名，方便在提示词里用 @alias 指代素材。音频参考需要与图片或视频参考一起使用；不要只提交 media_type=audio 的素材。

bash
curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-ld-17",
    "prompt": "让 @robot 自然挥手，镜头稳定，保持主体一致。",
    "duration": 8,
    "ratio": "16:9",
    "references": [
      {
        "media_type": "image",
        "role": "reference_image",
        "url": "https://example.com/robot.png",
        "alias": "robot"
      }
    ]
  }'

文生视频 ​

没有参考素材时，只传 prompt、duration 和 ratio 即可。

json
{
  "model": "seedance-2.0-ld-17",
  "prompt": "一只橘猫在阳光充足的窗台上缓慢转身，镜头稳定，画面自然",
  "duration": 8,
  "ratio": "9:16"
}

常用字段 ​

字段类型说明
modelstring固定填写 seedance-2.0-ld-17。
promptstring视频描述。建议包含主体、动作、镜头、场景和风格。
referencesarray推荐。通用素材引用数组。
references[].media_typestring常用 image、video 或 audio。
references[].rolestring常见值为 reference_image、first_frame、reference_video、reference_audio。
references[].urlstring公网 URL 或 MoonApiX 托管 URL。
references[].aliasstring可选。素材别名，例如 robot、hero、product。
image / image_urlstring兼容字段。单张参考图或首帧图 URL。
imagesarray兼容字段。图片素材数组。
videosarray兼容字段。视频素材数组。
audiosarray兼容字段。音频素材数组。音频参考需要与图片或视频参考一起使用，不要只传音频。
first_frame_urlstring兼容字段。首帧图 URL。
durationnumber/string视频时长，建议 5-15 秒；常用 8。
ratio / aspect_ratiostring画面比例，例如 1:1、16:9、9:16、4:3、3:4。
callback_urlstring可选。任务完成后的回调地址。

计费 ​

seedance-2.0-ld-17 按次计费。实际价格以 MoonApiX 后台「分组与模型定价设置」中的模型价格为准；未单独配置时使用站点默认价格。

查询结果 ​

创建响应只代表任务已提交，请保存 task_id 并继续查询。查询时先判断 status 和 error；任务成功后，再按 data.video_url、video_url、url、result_url、output.url、metadata.url 的顺序读取最终视频地址。

相关页面 ​