Skip to content

MaaS_Mureka Music Model API

Request Protocol

Http

Request eader

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

Request URL

https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/music?action={}

Request Body

Generate Song

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）

Request Example

curl -X 'https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/music?action=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 -X 'https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/music?action=song_query&task_id=105022188748801' \
-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）

Request Example

curl -X 'https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/music?action=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 -X 'https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/music?action=instrumental_query&task_id=105022188748801' \
-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 -X 'https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/music?action=file_upload' \
-H 'Authorization: Bearer ${Your AK}' \
-F 'file=@"/C:/Users/user/Downloads/music_songs_20251110.mp3"' \
-F 'purpose="audio"'