MoonNexAI API Docs

Appearance

moon-2.0-il 系列 ​

moon-2.0-il 系列是 MoonNexAI Moon-2 的 720P 按秒多素材视频模型线。当前公开型号为 moon-2.0-il-720p，支持文生视频，以及图片、视频和音频参考组合。创建任务时，model 固定填写 moon-2.0-il-720p。

当前配置 ​

项目说明
推荐入口POST /v1/videos
查询入口GET /v1/videos/{task_id} 或 GET /v1/tasks/{task_id}
推荐素材字段references[]
输出分辨率720P
支持时长4 到 14 秒
支持比例16:9、9:16、4:3、3:4、1:1、21:9
计费方式按秒计费；实际价格以模型列表、价格页和扣费记录为准

能力边界 ​

能力支持情况
文生视频支持
图片参考支持，最多 9 张
视频参考支持，最多 3 个
音频参考支持，最多 3 个
混合素材支持；图片、视频和音频合计最多 12 个
独立音频不支持；音频必须与至少一张图片一起提交
素材来源支持稳定公网 URL 和 MoonNexAI 托管 URL

调用示例 ​

bash
curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moon-2.0-il-720p",
    "prompt": "让 @角色 参考 @动作 自然表演，并使用 @音乐 作为背景音乐。",
    "duration": 10,
    "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": "background_music",
        "url": "https://example.com/music.mp3",
        "alias": "音乐"
      }
    ]
  }'

alias 不要带 @；提示词中使用 @alias 指代素材。URL 应可直接下载并保留真实文件后缀，不要依赖登录、Cookie、额外鉴权 Header 或一次性下载页。

常用字段 ​

字段类型说明
modelstring固定填写 moon-2.0-il-720p。
promptstring视频描述。建议写清主体、动作、场景、镜头和素材绑定。
durationnumber/string支持 4 到 14 秒。
ratio / aspect_ratiostring16:9、9:16、4:3、3:4、1:1 或 21:9。
resolutionstring填写 720P。
referencesarray推荐。图片、视频和音频引用数组，总数最多 12 个。
callback_urlstring可选。任务完成后的 HTTPS 回调地址。

查询与下载 ​

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

先检查 status 和 error。只有任务成功后才读取结果 URL；也可以使用标准内容入口：

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

相关页面 ​