Skip to content

MaaS_Mureka Music Model API

This request method is only applicable to the MaaS_Mureka_o1、MaaS_Mureka_v7.5 models。 For the MaaS_Mureka_o2 、MaaS_Mureka_v7.6 ，please refer to MaaS_Mureka_v7.6

Request Protocol

Http

Request eader

Parameters Value
Authorization Bearer {YOUR AK}
Content-Type application/json

Generate Song

Request URL

https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/song/generat

Request Body

Parameter Type Required Description
lyrics string Yes Lyrics content (required)
model string No Model version, optional:MaaS_Mureka_o1_generate、MaaS_Mureka_v7.5_ generate
n int No Number of songs generated per request, maximum 3, default 2
prompt string No Song prompt
reference_id string No Reference music ID, generated by the file upload interface (files/upload API)（purpose: reference）
vocal_id string No Vocal ID, generated by the file upload interface (files/upload API)（purpose: vocal）
melody_id string No Melody ID, generated by the file upload interface (files/upload API)（purpose: melody）
instrumental_id string No Instrumental reference ID, generated by the file upload interface (files/upload API)（purpose: instrumental）
stream boolean No If set to true, the status of the generation task will include a streaming phase. During this phase, you can obtain the stream_url of the generated song and play this URL, thereby enabling song playback while the generation is in progress.

Request Example

curl 'https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/song/generate' \
-H 'Authorization:  Bearer ${Your AK}' \
-H 'Content-Type:  application/json' \
-d '{
  "lyrics": "【Verse 1】\nYouth blooms like flowers\nDreams soar in the heart\n\n【Chorus】\nYouth and dreams\nForever in the heart",
  "model": "MaaS_Mureka_v7.5_generate",
  "n": 1,
  "prompt": "Create a pop song about youth and dreams"
}'

Query Task (Song)

Request Example

curl 'https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/song/query/{task_id}' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer ${Your AK}'

Generate Instrumental Music

Parameter Type Required Description
model string No Model version, optional：MaaS_Mureka_v7.5_ generate
n int No Number of songs generated per request, maximum 3, default 2
prompt string No Song prompt
instrumental_id string No Instrumental reference ID, generated by the file upload interface (files/upload API)（purpose: instrumental）
stream boolean No If set to true, the status of the generation task will include a streaming phase. During this phase, you can obtain the stream_url of the generated song and play this URL, thereby enabling song playback while the generation is in progress.

Request Example

curl 'https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/instrumental/generate' \
-H 'Authorization:  Bearer ${Your AK}' \
-H 'Content-Type:  application/json' \
-d '{
  "prompt": "Create a peaceful piano background music suitable for meditation and relaxation.",
  "model": "MaaS_Mureka_v7.5_generate"
}'

Query Task (Instrumental Music)

Request Example

curl 'https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/instrumental/query/{task_id}' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer ${Your AK}'

Upload File

Parameter Type Required Description
file file Yes File content to be uploaded
purpose string Yes File purpose. Valid values: reference, vocal, melody, instrumental, voice, audio

Request Example

curl 'https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/files/upload' \
-H 'Authorization: Bearer ${Your AK}' \
-F 'file=@"/C:/Users/user/Downloads/music_songs_20251110.mp3"' \
-F 'purpose="audio"'