MoonNexAI API Docs

Appearance

moon-2.0-gl 系列 ​

moon-2.0-gl 系列是 MoonNexAI Moon-2 的 720P 按次多素材视频模型线。当前公开型号包括标准版 moon-2.0-gl-a-720p 和快速版 moon-2.0-gl-a-720p-fast，两者使用相同的请求字段和素材边界。

型号选择 ​

模型定位计费方式
moon-2.0-gl-a-720p标准 720P 多素材生成按次计费
moon-2.0-gl-a-720p-fast快速 720P 多素材生成按次计费

实际可用状态和价格以 MoonNexAI 控制台、模型列表及价格接口为准。

当前配置 ​

项目说明
创建入口POST /v1/videos
查询入口GET /v1/videos/{task_id} 或 GET /v1/tasks/{task_id}
推荐素材字段references[]
素材来源可直接下载的稳定公网 URL，或已为当前任务准备好的 MoonNexAI 素材引用
分辨率720P
时长4 到 15 秒
比例16:9、9:16、1:1

能力边界 ​

能力支持情况
文生视频支持
图片参考支持，最多 4 张
首帧 / 尾帧支持，占用图片数量
视频参考支持，最多 3 个
音频参考支持，最多 1 个；必须同时提供图片或视频
混合素材最多 8 个，即 4 图 + 3 视频 + 1 音频
人物参考支持；参考图无需裁成仅人脸图片

图片角色可使用 reference_image、first_frame、last_frame、style_reference 或 character_reference。音频不能作为唯一参考素材单独提交。

创建任务 ​

纯文本生成 ​

bash
curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moon-2.0-gl-a-720p-fast",
    "prompt": "古风舞台上的专业舞蹈表演，人物边跳舞边唱歌，专业镜头切换。",
    "duration": 15,
    "ratio": "9:16",
    "resolution": "720p"
  }'

如需使用标准版，只需把 model 改为 moon-2.0-gl-a-720p。

图片、视频和音频组合 ​

json
{
  "model": "moon-2.0-gl-a-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 绑定对应素材。完整边界组合允许 4 张图片、3 个视频和 1 个音频，但新接入建议先用少量素材跑通，再逐步增加。

常用字段 ​

GL 系列遵循与通用 Moon / Seedance2.0 系列一致的 MoonNexAI 视频请求参数。标准版 moon-2.0-gl-a-720p 和快速版 moon-2.0-gl-a-720p-fast 使用同一套字段；MoonNexAI 会在服务端完成模型执行格式转换，客户端不需要传模型线路专用参数。

字段类型必填说明
modelstring是填写 moon-2.0-gl-a-720p 或 moon-2.0-gl-a-720p-fast。
promptstring是视频描述，最多 5000 个字符。建议写清主体、动作、场景、镜头和素材绑定。
duration / secondsnumber/string是视频时长，支持 4 到 15 秒；推荐使用 duration。
ratio / aspect_ratiostring是画面比例，支持 16:9、9:16、1:1。两个字段选择一个即可。
resolutionstring是填写 720p 或 720P。
referencesarray否推荐的通用素材引用数组；图片、视频和音频合计最多 8 个。纯文本任务可省略。
references[].media_typestring是素材类型：image、video、audio 或 music。
references[].rolestring是图片可用 reference_image、first_frame、last_frame、style_reference、character_reference；视频使用 reference_video；音频使用 reference_audio 或 background_music。
references[].urlstring是稳定公网 URL、MoonNexAI 托管 URL，或当前模型可用的 MoonNexAI 素材引用。
references[].aliasstring否素材别名，不带 @；提示词中使用 @alias 指代素材。
first_frame_url / last_frame_urlstring否首尾帧兼容写法。可以只传首帧，也可以同时传首帧和尾帧；不能只传尾帧，且首尾帧模式不能再与其他参考图片、视频或音频混用。
image / image_url / imagesstring/array否图片兼容写法，最多 4 张。新接入优先使用 references[]。
video / video_url / videosstring/array否视频兼容写法，最多 3 个。新接入优先使用 references[]。
audio / audio_url / audiosstring/array否音频兼容写法，最多 1 个，且必须搭配图片或视频。
contentarray否通用多模态兼容数组；复杂素材的新接入仍推荐使用 references[]。
callback_urlstring否任务完成后的 HTTPS 回调地址。

使用音频时，必须同时提交至少一张图片或一个视频。首帧和尾帧都计入 4 张图片上限。

素材 URL 要求 ​

  • URL 必须允许匿名下载，不依赖登录态、Cookie 或额外鉴权 Header。
  • URL 路径建议保留 .png、.jpg、.mp4、.wav、.mp3 等真实文件后缀。
  • 视频和音频地址应在提交前确认状态、媒体类型、文件大小和时长满足模型要求。
  • 不要使用即将过期的一次性签名地址；本地或不稳定素材可先通过 /v1/assets/uploads 准备为 MoonNexAI 可访问素材。

查询结果 ​

创建响应只表示任务已提交。保存 task_id 或 id，然后查询任务：

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

先检查 status 和 error。任务成功后，可使用标准内容入口读取视频：

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

相关页面 ​