MoonApiX Docs

Appearance

seedance-2.0-am 系列 ​

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

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

当前配置 ​

项目说明
推荐入口POST /v1/videos
查询入口GET /v1/videos/{task_id} 或 GET /v1/tasks/{task_id}
推荐素材字段references[]
推荐素材来源稳定公网 URL；本地文件可先用 /v1/assets/uploads 的 mode=oss 获取 MoonApiX 托管公网 URL
输出720P
计费方式按次计费；实际价格以 MoonApiX 后台价格页和模型列表接口为准

能力边界 ​

能力支持情况
文生视频支持
图片参考支持，最多 9 张
视频参考支持，最多 3 个
音频参考支持，最多 3 个
混合素材支持；建议同时控制图片、视频、音频总数，避免一次请求过大
references[] 通用素材支持
Asset:// 素材引用不作为当前 AM 系列输入路径；请传公网 URL
独立音频素材不建议单独使用；通常应同时提供图片或视频参考

推荐流程 ​

AM 系列当前推荐用公网 URL 组织素材：

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

不要把 Asset://asset_xxx 作为 AM 任务的主要输入格式。

准备公网 URL ​

AM 系列的视频、图片和音频参考建议使用 MoonApiX 可直接下载的公网直链。为了减少第三方素材抓取失败或媒体类型误判，建议：

  • URL 路径保留真实文件后缀，例如 .png、.jpg、.mp4、.wav、.mp3。
  • URL 不依赖登录态、Cookie、额外鉴权 Header、一次性下载页或防盗链校验。
  • 尽量使用稳定、简短、无复杂 query 的直链；如果只能拿到本地文件或临时链接，先用 /v1/assets/uploads 的 mode=oss 获取 MoonApiX 托管公网 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-am-720p-fast" \
  -F "type=image" \
  -F "file=@reference.png"

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

创建视频任务 ​

单图参考 ​

bash
curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-am-720p-fast",
    "prompt": "专业拍摄该女子走秀，专业镜头切换，每个镜头都有惊艳点。",
    "duration": 15,
    "ratio": "9:16",
    "resolution": "720p",
    "references": [
      {
        "media_type": "image",
        "role": "reference_image",
        "url": "https://example.com/reference.png",
        "alias": "图片1"
      }
    ]
  }'

图片 + 背景音乐 ​

json
{
  "model": "seedance-2.0-am-720p-fast",
  "prompt": "音频1作为背景音乐，图片1女子在做高难度健身动作。",
  "duration": 15,
  "ratio": "9:16",
  "resolution": "720p",
  "references": [
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "https://example.com/person.png",
      "alias": "图片1"
    },
    {
      "media_type": "audio",
      "role": "reference_audio",
      "url": "https://example.com/background-music.mp3",
      "alias": "音频1"
    }
  ]
}

多素材组合 ​

json
{
  "model": "seedance-2.0-am-720p-fast",
  "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": "音乐"
    }
  ]
}

alias 不要带 @；提示词里用 @alias 绑定素材。图片、视频和音频越多，素材抓取与审核失败概率越高；新接入建议先用单图或图片 + 音频跑通，再增加素材数量。

常用字段 ​

字段类型说明
modelstring固定填写 seedance-2.0-am-720p-fast。
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公网 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

也可以在任务成功后使用标准内容入口下载：

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

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

注意事项 ​

  • AM 系列当前推荐公网 URL 或 MoonApiX 托管公网 URL；不要把 Asset://asset_xxx 作为 AM 任务输入。
  • 公开视频结果会返回 MoonApiX 可访问的视频地址；不要依赖或解析非公开下载地址。
  • 音频参考需要与图片或视频参考一起使用，不建议提交音频-only 任务。
  • 参考音频作为背景音乐时，请在提示词中明确说明“使用 @音乐 作为背景音乐”；不要同时要求它作为人物说话音色或台词内容。
  • 如果参考音频、参考视频没有被稳定识别，优先检查 URL 是否为可直接下载的公网媒体文件，且路径有真实后缀、无额外鉴权要求。
  • 若素材安全检查失败或 URL 无法访问，请更换素材 URL，或先用 mode=oss 上传为 MoonApiX 托管公网 URL。

相关页面 ​