Skip to content

Moon-2.0-il series ​

The moon-2.0-il family provides 720P MoonNexAI Moon-2 mixed-media video billed per second. Set model to moon-2.0-il-720p for text-to-video or combinations of image, video and audio references.

Current Configuration ​

ItemAnnotations
Recommended entrancePOST /v1/videos
Query EntryGET /v1/videos/{task_id} or GET /v1/tasks/{task_id}
Recommended media fieldreferences[]
Output resolution720P
Support duration4 to 14 sec
Support aspect ratio16:9, 9:16, 4:3, 3:4, 1:1, 21:9
billing Methodbilling seconds; actual price based on model list, price page and deduction record

Capacity boundaries ​

CapacitySupport
text-to-videoSupport
Picture referenceSupport, maximum 9
Video referenceSupport, up to 3
Audio ReferenceSupport, up to 3
Mixed media assetssupport;up to 12 pictures, videos and audio
Independent AudioNot supported; audio must be submitted with at least one picture
media assets SourceSupport for Stable Public Network URLs and MoonNexAI hosting URLs

Call Example ​

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": "音乐"
      }
    ]
  }'

Omit @ from alias; refer to it as @alias in the prompt. URLs must download directly and retain their real file extensions, without requiring login, cookies, extra authentication headers or one-time download pages.

Common field ​

fieldTypeAnnotations
modelstringFixed to fill moon-2.0-il-720p.
promptstringVideo description. It is recommended to write about the subject, the action, the scene, the lens and the media assets binding.
durationnumber/stringSupports 4 to 14 seconds.
ratio / aspect_ratiostring16:9, 9:16, 4:3, 3:4, 1:1 or 21:9.
resolutionstringFill in 720P.
referencesarrayRecommended. Picture, video and audio reference arrays, with a maximum of 12.
callback_urlstringOptional. HTTPS callback addresses after task is completed.

Query and Download ​

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

Check status and error. Only task success will lead to URLs; standard content entry is also available:

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

Relevant Pages ​