Moon-2.0-gl series
The moon-2.0-gl family provides 720P MoonNexAI Moon-2 mixed-media video billed per task. Standard moon-2.0-gl-a-720p and Fast moon-2.0-gl-a-720p-fast use the same fields and reference limits.
Model Selection
| Models | Positioning | billing Method |
|---|---|---|
moon-2.0-gl-a-720p | Standard 720P mixed-media generation | Billed per task |
moon-2.0-gl-a-720p-fast | Rapid 720P multi-media assets generation | Press the next billing |
The actual availability and price are based on MoonNexAI console, the model list and price API.
Current Configuration
| Item | Annotations |
|---|---|
| Create Entry | POST /v1/videos |
| Query Entry | GET /v1/videos/{task_id} or GET /v1/tasks/{task_id} |
| Recommended media field | references[] |
| media assets Source | Stable public network URL that can be downloaded directly, or MoonNexAI media assets quotes that are ready for current task |
| resolution | 720P |
| duration | 4 to 15 sec |
| aspect ratio | 16:9, 9:16, 1:1 |
Capacity boundaries
| Capacity | Support |
|---|---|
| text-to-video | Support |
| Picture reference | Support, up to 4 |
| First / last frame | Support, take up the number of pictures |
| Video reference | Support, up to 3 |
| Audio Reference | Support, up to 1; pictures or videos must be provided at the same time |
| Mixed media assets | Maximum 8 or 4 + 3 Video + 1 Audio |
| Personal Reference | support;reference images need not be reduced to a face-to-face image |
Picture roles can be reference_image, first_frame, last_frame, style_reference or character_reference. Audio cannot be submitted as a single reference media assets.
Create task
Pure Text Generation
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"
}'If a standard version is to be used, only model should be replaced with moon-2.0-gl-a-720p.
Pictures, videos and audio combinations
{
"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": "音乐"
}
]
}Omit @ from alias and use @alias in the prompt. The maximum combination is 4 images, 3 videos and 1 audio file. Start with fewer references and increase them gradually.
Common field
The GL series follows the parameters of the MoonNexAI video request, which is consistent with the generic Moon / Seedance2.0 series. Standard version moon-2.0-gl-a-720p and fast version moon-2.0-gl-a-720p-fast use the same set of field; MoonNexAI completes the model format conversion at the service end, and the client does not need to pass on specific parameters for the model line.
| field | Type | shall fill | Annotations |
|---|---|---|---|
model | string | Yes. | Fill in moon-2.0-gl-a-720p or moon-2.0-gl-a-720p-fast. |
prompt | string | Yes. | Video description, up to 5,000 characters. It is recommended to write the subject, action, scene, lens and media assets binding. |
duration / seconds | number/string | Yes. | Video duration, supporting 4 to 15 seconds; recommended duration. |
ratio / aspect_ratio | string | Yes | Aspect ratio: 16:9, 9:16 or 1:1. Use either field. |
resolution | string | Yes. | Fill in 720p or 720P. |
references | array | Yes | The recommended generic media assets reference array; total of pictures, videos and audio is up to 8. The pure task text is omitted. |
references[].media_type | string | Yes. | media assets type: image, video, audio or music. |
references[].role | string | Yes. | Pictures can be used reference_image, first_frame, last_frame, style_reference, character_reference; video reference_video; audio reference_audio or background_music. |
references[].url | string | Yes. | Stable public network URL, MoonNexAI hosting URL, or MoonNexAI media assets references available for the current model. |
references[].alias | string | Yes | media assets aliases, without @; prompt uses @alias for media assets. |
first_frame_url / last_frame_url | string | Yes | first and last frames Compatibility. Only first frame can be passed, or first frame and last frame can be used simultaneously; last frame cannot be used only, and first and last frames can no longer be used in conjunction with other reference images, video or audio. |
image / image_url / images | string/array | Yes | Picture Compatibility Method, maximum 4. New access is preferred to references[]. |
video / video_url / videos | string/array | Yes | Video Compatible Writing Method, maximum 3. New access is preferred to references[]. |
audio / audio_url / audios | string/array | Yes | Audio compatible writing, up to 1 and must be accompanied by pictures or videos. |
content | array | Yes | Generic multi-modular compatible arrays; complex media assets new access is still recommended references[]. |
callback_url | string | Yes | Address of HTTPS callback after task completion. |
When using audio, you must submit at least one picture or video at the same time. first frame and last frame are included in the upper limit of four pictures.
media assets URL request
- URLs must allow anonymous downloads without relying on login, Cookie or extra authentication Header.
- URL path suggests retaining the suffix of
.png,.jpg,.mp4,.wav,.mp3, etc. - The video and audio addresses should confirm the status, media type, file size and duration before submission to meet the model requirements.
- Avoid signed URLs that are about to expire. Local or unstable inputs can be prepared through
/v1/assets/uploadsas media accessible to MoonNexAI.
Query Results
Create response means that only task has been submitted. Save task_id or id and then query task:
curl https://moonnexai.com/v1/videos/{task_id} \
-H "Authorization: Bearer <MOONNEXAI_API_KEY>"Check status and error. After task is successful, you can read video using the standard content portal:
curl -L https://moonnexai.com/v1/videos/{task_id}/content \
-H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
-o output.mp4