Moon-2.0-dj series
The moon-2.0-dj family provides 720P MoonNexAI Moon-2 video billed per second. Its public model, moon-2.0-dj-fast, supports text-to-video, single-image generation and multiple image references. Future public moon-2.0-dj-* models will be documented here.
When task is created, the POST /v1/videos, media assets is placed in the references[]. When searching for results, check task status and error, only succeeded before reading the URL.
Current Configuration
| Item | Annotations |
|---|---|
| Current Model | moon-2.0-dj-fast |
| Recommended entrance | POST /v1/videos |
| Query Entry | GET /v1/videos/{task_id} or GET /v1/tasks/{task_id} |
| Recommended media field | references[] |
| resolution | 720P |
| duration | 5, 10, 15 sec |
| aspect ratio | 16:9, 9:16 |
| billing Method | Press the second billing. |
Capacity boundaries
| Capacity | Support | Annotations |
|---|---|---|
| text-to-video | Support | Only prompt, duration, ratio and resolution can be passed. |
| Picture reference | Support | Use references[], up to 9 pictures. |
| First-frame image-to-video | Supported | Set the image's role in references[] to first_frame. |
| Multi-reference images | Support | Use multiple reference_image entries in references[]. |
| Video reference | Not supported | Do not pass reference_video, videos[] or Video URL field. |
| Independent Audio | Not supported | Do not pass reference_audio, audios[], audio_url or independent audio media assets. |
reference images policy
moon-2.0-dj-fast does not require face-only images and is not a face-locking or face-swap API. Images may reference full-body subjects, clothing, products, scenes, composition or style. The model combines the prompt and references. For consistent characters, use clear, unobstructed images of the same subject and specify the character, actions and camera movement.
Example text-to-video
curl https://moonnexai.com/v1/videos \
-H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "moon-2.0-dj-fast",
"prompt": "A clean cinematic product video, soft studio light, slow camera push-in.",
"duration": 10,
"ratio": "16:9",
"resolution": "720P",
"callback_url": "https://example.com/moonnexai/webhook"
}'Example reference images
New access is given priority references[]. alias gives name to media assets and allows for @alias to be used in prompt.
{
"model": "moon-2.0-dj-fast",
"prompt": "Use @product as the main subject, create a short vertical ad with a smooth handheld camera move.",
"duration": 10,
"ratio": "9:16",
"resolution": "720P",
"references": [
{
"media_type": "image",
"role": "reference_image",
"url": "https://example.com/product.png",
"alias": "product"
}
]
}Multigraph Example
references[] accepts up to 9 images using public or MoonNexAI-hosted URLs. Whether Asset://asset_xxx is accepted depends on the asset status and current model documentation.
{
"model": "moon-2.0-dj-fast",
"prompt": "Combine @hero and @product into a bright lifestyle commercial, keep both subjects recognizable.",
"duration": 15,
"ratio": "16:9",
"resolution": "720P",
"references": [
{
"media_type": "image",
"role": "reference_image",
"url": "https://example.com/hero.jpg",
"alias": "hero"
},
{
"media_type": "image",
"role": "reference_image",
"url": "https://example.com/product.jpg",
"alias": "product"
}
]
}Common field
| field | Type | Annotations |
|---|---|---|
model | string | Fixed to fill moon-2.0-dj-fast. |
prompt | string | Video description. The recommendations include the subject, action, lens, scenery and style. |
duration | integer | 5, 10, 15. Do not send non-quantifiable values such as 8, 12. |
ratio / aspect_ratio | string | Support 16:9, 9:16. |
resolution | string | Current use 720P. |
references[] | array | Recommended media assets arrays. Only pictures media assets with a maximum of 9. |
references[].media_type | string | Current fill image. |
references[].role | string | Common values are reference_image, first_frame. |
references[].url | string | Photo public web URL or MoonNexAI hosting URL. |
references[].alias | string | Optional. media assets alias, e.g. hero, product. |
callback_url | string | Optional. After task is finished, receive the HTTPS address of callback. |
Query Results
Save id or task_id: in response after successful submission
curl https://moonnexai.com/v1/videos/task_01HX... \
-H "Authorization: Bearer <MOONNEXAI_API_KEY>"Client should first judge status:
| Status | Client processing |
|---|---|
submitted / pending / running | Continue polling or wait for a webhook. |
succeeded | Read url, video_url, output.url or metadata.url. |
failed | Read error and keep request_id/trace_id for ease of search. |
cancelled | task has been cancelled and the result URL is not read. |
Result URL
moon-2.0-dj-fast returns the MoonNexAI hosting media URL after success. The client should save the complete URL that actually returns from the query response, without assuming a fixed domain name, and without aggregating the result URL after split.
The client side video results are used in a uniform manner by MoonNexAI with its own controlled address. The business system needs only to read and save the complete URL at field priority after status=succeeded.
billing Description
moon-2.0-dj-fast is billing in seconds. The actual price, grouping factor and deduction rate are based on the MoonNexAI console and billing records.
FAQ
Can you pass any seconds between 5 and 15?
Can not. Only three count-up values of 5, 10, 15 are currently supported.
Can you send video or audio references?
Can not. moon-2.0-dj-fast currently supports only photo references, not reference video and independent audio.
How many reference images can I submit?
Up to 9. If you have more than 9 please screen key pictures on the side of the operation before submitting task.