MoonApiX Docs

Appearance

moon-2.0-me 系列 ​

moon-2.0-me 是 MoonApiX 的 720P 按次视频模型系列，支持文生视频、图生视频和参考素材视频。请在请求中使用公开模型名，不要依赖其他模型的参数边界。

可用型号 ​

公开模型适合场景主要能力
moon-2.0-me-a-720p标准图片参考视频文生视频或最多 9 张图片参考；不支持参考视频和参考音频。
moon-2.0-me-b-720p多素材参考视频文生视频或最多 9 张图片、3 个视频、3 个音频；合计最多 15 个素材。
moon-2.0-me-a-fast快速图片参考视频能力边界与 A 720P 相同；最多 9 张图片参考，不支持参考视频和参考音频。

三个型号均支持 720P、5 / 10 / 15 秒，以及 16:9、9:16、1:1、4:3、3:4 比例。实际可用状态和价格以模型列表、价格页和扣费记录为准。

能力边界 ​

能力A 720P / A FastB 720P
文生视频支持支持
图片参考最多 9 张最多 9 张
视频参考不支持最多 3 个
音频参考不支持最多 3 个
参考素材总数最多 9 个最多 15 个
音频单独提交不适用不支持；至少同时提供一张图片或一个视频
输出分辨率720P720P
时长5、10、15 秒5、10、15 秒
比例16:9、9:16、1:1、4:3、3:416:9、9:16、1:1、4:3、3:4

推荐请求 ​

单张图片参考 ​

bash
curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moon-2.0-me-a-720p",
    "prompt": "让 @主体 缓慢向镜头走来，保持主体外观和冷色光线，电影感运镜。",
    "duration": 15,
    "ratio": "16:9",
    "resolution": "720P",
    "references": [
      {
        "media_type": "image",
        "role": "reference_image",
        "url": "https://example.com/subject.jpg",
        "alias": "主体"
      }
    ]
  }'

九图、一视频、一音频 ​

json
{
  "model": "moon-2.0-me-b-720p",
  "prompt": "参考图片保持场景和色彩，参考视频提供运动节奏，使用参考音频作为背景声音。",
  "duration": 15,
  "ratio": "16:9",
  "resolution": "720P",
  "references": [
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "https://example.com/image-1.jpg"
    },
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "https://example.com/image-2.jpg"
    },
    {
      "media_type": "video",
      "role": "reference_video",
      "url": "https://example.com/motion.mp4",
      "alias": "运动"
    },
    {
      "media_type": "audio",
      "role": "reference_audio",
      "url": "https://example.com/sound.wav",
      "alias": "声音"
    }
  ]
}

上例只展示两张图片；实际最多可以传入 9 张图片。音频必须和图片或视频一起提交。alias 不要包含 @，提示词中使用 @alias 指代对应素材。

查询任务 ​

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

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

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

注意事项 ​

  • 参考媒体必须是任务执行期间可匿名访问、无需 Cookie 或额外请求头的稳定公网直链。
  • URL 建议保留真实文件后缀，例如 .jpg、.png、.mp4、.wav 或 .mp3。
  • 需要复用素材时，可先使用素材接口；是否支持 Asset://asset_xxx 以目标模型和素材状态为准。
  • 任务最终时长和结果字段以查询接口返回为准，不要仅根据请求参数判断任务成功。

相关页面 ​