Musical Overview
Music APIs generate songs, lyrics, sound effects and post-processing tasks. Submit through the asynchronous task API, save task_id, then query status, failure details and media results through the common task endpoint.
The scene entrance.
Generate Generates music and sound produces songs, pure music and sound. Edit Editor Music extensions, recreates, accompanies, sounds, Mashup and replaces the clips. Post Reprocessing lyrics, cover, WAV, MIDI, MP4 and human voice separated. Query Query and Download Query task status, then read and download media after success.
Route List
| Methodology | Path | Purpose |
|---|---|---|
POST | /v1/tasks | Creates music, lyrics, sound or audio after-processing task. |
GET | /v1/tasks/{task_id} | Ask for task status, cause of failure and result. |
POST | /v1/assets/uploads | Uploads or registers reusable audio media assets. |
GET | /v1/assets/{asset_id} | Find media assets details. |
Standard request
bash
curl https://moonnexai.com/v1/tasks \
-H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-music-v5.5",
"prompt": "A hopeful pop song about finding light after a long night.",
"style": "Pop, Warm, Emotional",
"title": "Morning Light",
"customMode": true,
"instrumental": false,
"callBackUrl": "https://example.com/moonnexai/webhook"
}'Query Results
bash
curl https://moonnexai.com/v1/tasks/task_xxx \
-H "Authorization: Bearer <MOONNEXAI_API_KEY>"First judge status. Only if status is succeeded or SUCCESS will read media URLs; if task fails, response will contain fail_reason or error field for display and retesting.
Editing or post-processing may require media[].suno_audio_id from the source task as audioId. Wait for the source task to succeed before requesting an extension, WAV conversion, vocal separation or MP4 creation.