Moon-2.0-am series

The moon-2.0-am series is the MoonNexAI Moon-2 multi-media assets video model line. The current open model is moon-2.0-am-720p-fast, which allows for the rapid generation of 720P videos and the combination of pictures, videos and audio references in the same task.

When task is created, model is fixed to fill moon-2.0-am-720p-fast.

Current Configuration

Item	Annotations
Recommended entrance	POST /v1/videos
Query Entry	GET /v1/videos/{task_id} or GET /v1/tasks/{task_id}
Recommended media field	references[]
Recommended media source	Stable URLs from your own storage for production use; mode=oss can provide temporary URLs for local integration tests
Output	720P
billing Method	Billed per task; actual price is based on MoonNexAI console price page and model list API

Capacity boundaries

Capacity	Support
text-to-video	Support
Picture reference	Support, maximum 9
Video reference	Support, up to 3
Audio Reference	Support, up to 3
Mixed media assets	Support; it is recommended to control the total number of pictures, videos and audio at the same time, avoiding an oversized request at a time
references[] Universal media assets	Support
Asset:// references	Not a current AM input method; use public URLs
Independent Audio media assets	Not recommended for use alone; usually, photo or video references should be provided at the same time

Recommended Process

The current recommendation for the AM series is a public network URL to organize media assets:

1. Images, videos and audio URLs that are intended to be accessed by MoonNexAI.
2. When you connect local media assets, you can call /v1/assets/uploads and use mode=oss to get a temporary test URL; for official business, use the stable public network URL that the customer has stored.
3. Call /v1/videos, setting references[].url to each public URL.

Do not use Asset://asset_xxx as the main input format for AM task.

Prepare public network URL

In order to reduce third-party media assets capture failures or media-type miscalculation, it is recommended that:

• URL path retains the real file suffix, e. g. .png, .jpg, .mp4, .wav, .mp3.
• URL does not rely on login, Cookie, extra authentication Header, one-time download page or security chain verification.
• Use of a straight chain of stable, short, uncomplicated query in the customer ' s own storage; mode=oss is used only as a temporary test capability for the association of local files and does not guarantee long-term validity.
• When you use a sound as a background music, you clearly say " Use @music as background music" in prompt and do not write " voice, verb or lines " .

Local File Transfer OSS Test URL

curl https://moonnexai.com/v1/assets/uploads \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -F "mode=oss" \
  -F "model=moon-2.0-am-720p-fast" \
  -F "type=image" \
  -F "file=@reference.png"

After uploading successfully, enter the returned public web url/ public_url into the references[].url of Video task.

Create a video task

Single Chart Reference

curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moon-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"
      }
    ]
  }'

Picture + Background Music

{
  "model": "moon-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"
    }
  ]
}

Multi-media assets grouping

{
  "model": "moon-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": "音乐"
    }
  ]
}

Omit @ from alias and use @alias in the prompt. More images, videos and audio files increase the chance of retrieval or review failures. Start with one image or an image plus audio before adding more references.

Common field

field	Type	Annotations
model	string	Fixed to fill moon-2.0-am-720p-fast.
prompt	string	Video description. It is recommended to write about the subject, the action, the scene, the lens and the media assets binding.
duration	number/string	Video duration. Current suggestion 4 to 15 seconds.
ratio / aspect_ratio	string	Video aspect ratio, for example 16:9, 9:16, 1:1.
resolution	string	It is recommended that 720p be completed.
references	array	Recommended. Generic media assets reference array.
references[].media_type	string	image, video, audio or music.
references[].role	string	Common values are reference_image, character_reference, style_reference, reference_video, reference_audio, background_music.
references[].url	string	URL or MoonNexAI hosting web URL.
references[].alias	string	Optional. prompt is a bound name, such as hero, 角色, 音乐.
callback_url	string	Optional. callback addresses after task is completed.

Query Results

Create response has only been submitted for task, save task_id and continue with the query:

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

After the success of task, it is recommended that the final video address be read in this order:

data.video_url
video_url
url
result_url
output.url
metadata.url

You can also download the standard content portal after task success:

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

Please first determine whether status is succeeded. If task is still pending, submitted or running, continue with polling and the same task_id.

Attention

• The AM series of official operations uses the public network URL of the customer-owned storage; MoonNexAI OSS URL only for the intercom test. Do not enter Asset://asset_xxx as AM task.
• The public video results return to the video address that MoonNexAI can access; do not rely on or interpret the address for undisclosed downloads.
• Audio reference needs to be used with a picture or video reference, and is not recommended for the audio-only task.
• When reference audio is used as background music, please specify in prompt that “use @music as background music”; do not ask it to speak as a character voice or the content of the line.
• If reference audio, reference video, is not identified in a stable way, check if URLs are directly downloadable public media files, with a real suffix and no additional authentication requirements.
• If media assets security check fails or URLs cannot be accessed, replace with a stable URL that is anonymously accessible in the client's own storage; mode=oss can only be used for in-link searches.

Relevant Pages

• Moon-2 Video Overview
• Create Video Job
• Query Video Job
• Uploading and Media Asset Overview