MoonNexAI API Docs

English

简体中文

English

简体中文

Appearance

Moon-2 AC Series ​

The Moon-2 AC model is a stand-alone public video model. Use the full model value in the following table; do not extrapolate other models by suffixing the model. The current price amount is based on the price API and console, which only describes billing dimensions.

Model Matrix ​

ModelresolutiondurationEnter media assetsbilling-DDetails
moon-2.0-ac-a-480p480P15 secFigure 1-9, maximum 3 video and 3 audio, total, maximum 15; at least 1 mapBy NumberDetails
moon-2.0-ac-a-720p720P10 or 15 secondsUp to 9 pictures; video and audio are not supportedBy NumberDetails
moon-2.0-ac-b-720p-fast720P15 secMaximum 9 figures, 3 videos, 3 audio, total 15By NumberDetails
moon-2.0-ac-c-720p720P15 secUp to 9 pictures; video and audio are not supportedBy NumberDetails
moon-2.0-ac-d-720p720P15 secUp to 9 pictures; video and audio are not supportedBy NumberDetails
moon-2.5-ac-a-480p480P4-30 secondsup to 30 pictures; video and audio are not supportedPress secondsDetails
moon-2.5-ac-a-720p720P4-30 secondsup to 30 pictures; video and audio are not supportedBy NumberDetails
moon-2.5-ac-b-720p720P4-30 seconds30, 10, 10, 10 audio, 50, totalPress secondsDetails
moon-2.5-ac-c-720p720P4-30 seconds, but does not support 5, 10, 15 seconds30, 10, 10, 10 audio, 50, totalBy NumberDetails

Universal request engagement ​

Create tasks with POST /v1/videos and query with GET /v1/videos/{task_id} or GET /v1/tasks/{task_id}. Prefer references[], supplying media_type, role, url and optional alias. Follow each model's media, duration and billing limits; do not transfer one model's capabilities to another.

media assets URLs must be accessible anonymously and the type of media corresponds to the statement. The creation of response has been submitted only on behalf of task; the results must be read after status and error.

Description of parameters ​

fieldTypeAnnotations
modelstringYou will fill in. Use the complete MoonNexAI public model ID in this page matrix. Do not spell the model name by a, b, c, d or resolution after the suffix.
promptstringVideo description. Whether to allow a pure text-to-video by-decision; moon-2.0-ac-a-480p, moon-2.0-ac-a-720p, moon-2.0-ac-c-720p, moon-2.0-ac-d-720p must provide a graphic reference.
duration / secondsinteger / stringTarget duration. Only the values listed in the matrix can be submitted; no other values are passed on for the fixed 15-second model. duration is recommended.
ratio / aspect_ratiostringAspect ratio. Current AC models accept 16:9 or 9:16; if both fields are supplied, their values must agree.
resolutionstringOutput resolution, fill 480P or 720P, must match the selected model.
references[]arrayThe recommended flat media assets arrays. The entries use media_type, role, url and optional alias.
references[].media_typestringimage, video or audio. Specific available types are limited by model matrix.
references[].rolestringThe picture is usually reference_image; the video is reference_video; the audio is reference_audio or background_music. Unsupported characters are rejected before creation.
references[].urlstringAn anonymous downloadable URL for the public media, or Asset://asset_xxx for the model.
callback_urlstringOptional. HTTPS callback addresses after task is completed.
watermark / seedboolean / integerOptional control field. Only if the current model list shows support; no other series of control field is brought directly into AC request.

Type difference and rejection of boundary ​

ModelCould submitUncertainly not to submit
moon-2.0-ac-a-480p1-9 photos, up to 3 videos and 3 audio, for a total of up to 15; fixed 15 seconds, 480 Pplain text;first and last frames role;exceeding quantitative limit
moon-2.0-ac-a-720p1-9 pictures; 10 or 15 seconds, 720 Ppure text; video; audio; other picture roles
moon-2.0-ac-b-720p-fastPlain text, or maximum 9 +3 Video + 3 Audio, total of 15; fixed 15 seconds, 720Pfirst and last frames role; exceeding maximum number
moon-2.0-ac-c-720p1-9 pictures; fixed 15 seconds, 720Ppure text; video; audio; other picture roles
moon-2.0-ac-d-720p1-9 pictures; fixed 15 seconds, 720Ppure text; video; audio; other picture roles
moon-2.5-ac-a-480pplain text or up to 30 pictures; 4-30 seconds, 480PVideos; Audio; Other Photo Roles
moon-2.5-ac-a-720pplain text or up to 30 pictures; 4-30 seconds, 720PVideos; Audio; Other Photo Roles
moon-2.5-ac-b-720pPlain text or maximum 30 + 10 Video + 10 Audio, total maximum 50; 4-30 seconds, 720 PUnsupported role;over the quantitative ceiling
moon-2.5-ac-c-720pmedia assets type and number of the same as B; duration is 4-30 seconds but does not support 5, 10, 15 seconds5, 10, 15 seconds; non-supported role; exceeding quantitative ceiling

Create Example ​

2.0 AC-A 480P: Picture + Video + Audio ​

bash
curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moon-2.0-ac-a-480p",
    "prompt": "让 @主体 按照 @动作 的节奏运动，并使用 @音乐 作为背景音乐。",
    "duration": 15,
    "ratio": "16:9",
    "resolution": "480P",
    "references": [
      {"media_type": "image", "role": "reference_image", "url": "https://example.com/subject.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": "音乐"}
    ]
  }'

2.0 AC-B Fast: Pure text or hybrid reference ​

json
{
  "model": "moon-2.0-ac-b-720p-fast",
  "prompt": "生成一段棚拍产品广告，镜头缓慢推进。",
  "duration": 15,
  "ratio": "9:16",
  "resolution": "720P"
}

If media assets is used, only references[] is added to the same request model; this model accepts up to 9 pictures, 3 videos and 3 audio, for a total of not more than 15.

2.5 AC-A: Pure text or photo references ​

json
{
  "model": "moon-2.5-ac-a-720p",
  "prompt": "让 @产品 在干净的摄影棚中缓慢旋转。",
  "duration": 8,
  "ratio": "16:9",
  "resolution": "720P",
  "references": [
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "https://example.com/product.png",
      "alias": "产品"
    }
  ]
}

2.5 AC-B: Picture + Video + Audio ​

json
{
  "model": "moon-2.5-ac-b-720p",
  "prompt": "保持 @主体 的外观，参考 @动作 的运动节奏，并使用 @音乐 作为背景音乐。",
  "duration": 8,
  "ratio": "16:9",
  "resolution": "720P",
  "references": [
    {"media_type": "image", "role": "reference_image", "url": "https://example.com/subject.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": "音乐"}
  ]
}

moon-2.5-ac-c-720p can reuse this request structure, but duration cannot use 5, 10 or 15; for example, change to 8.

Query and Download ​

Create response to only accept task. Save returned id or task_id, then polling:

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

Check status and error. Only when status=succeeded is the result URL read and download with the Unified Content Entry:

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

Relevant Pages ​