Mureka โ
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcAudioTask
Mureka is a music generation model with three modes: lyrics to song, prompt to song, and instrumental generation. Versions song_8, song_9, song_9.5, easy_song_9.5, and instrumental_9.5 are available; the three 9.5 versions were launched on 2026-11-16.
See Version differences to pick a version and Calling by version for request examples.
Basic Information โ
| Item | Value |
|---|---|
| ModelName | Mureka |
| ModelVersion | song_8 / song_9 / song_9.5 / easy_song_9.5 / instrumental_9.5 |
| SceneType | Not required โ leave it empty |
| Use | Lyrics to song (song_*) / prompt to song (easy_song_9.5) / instrumental (instrumental_9.5) |
Version differences โ
| ModelVersion | Mode | Lyrics (lyrics) | Vocals | Upstream Mureka API |
|---|---|---|---|---|
song_8 | Lyrics to song | โ | โ | Lyrics to song |
song_9 | Lyrics to song | โ | โ | Same as above |
song_9.5 | Lyrics to song | โ | โ | Same as above |
easy_song_9.5 | Prompt to song only | โ | โ | Prompt to song |
instrumental_9.5 | Instrumental | โ | โ (no vocals) | Generate instrumental |
How to choose:
- You have lyrics โ
song_9.5(the latest);song_8/song_9remain available. - You only have a description and want the model to write the song โ
easy_song_9.5. - Background music with no vocals โ
instrumental_9.5.
The integration guide only states that
easy_song_9.5"supports prompt-to-song only" andinstrumental_9.5"generates instrumentals". The "Lyrics" and "Vocals" columns above are inferred from the corresponding upstream Mureka APIs, which have no lyrics field for those two endpoints. Do not passlyricsto them.
Request Parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
SubAppId | Optional | Integer | VOD application ID |
ModelName | Optional | String | Mureka |
ModelVersion | Optional | String | song_8 / song_9 / song_9.5 / easy_song_9.5 / instrumental_9.5 |
SceneType | Optional | String | Not required |
Prompt | Optional | String | Style / instrument / mood / scene description |
OutputConfig | Optional | Object | Output settings, see below |
AdditionalParameters | Optional | String | JSON string. Lyrics go in lyrics (song_* only) |
OutputConfig โ
| Field | Description |
|---|---|
StorageMode | Temporary: not stored in VOD; a temporary URL valid for 7 days is returned in the event notification. Permanent: stored in VOD; a FileId is returned |
OutputAudioFormat | Output format: mp3 / wav / flac. Leave empty to use the default |
Calling by version โ
Lyrics to song (song_9.5) โ
Same call for song_8 / song_9 โ just change ModelVersion.
{
"ModelName": "Mureka",
"ModelVersion": "song_9.5",
"Prompt": "Upbeat synth-pop, female vocal, bright and catchy chorus",
"SubAppId": 123456789,
"OutputConfig": {
"StorageMode": "Temporary",
"OutputAudioFormat": "wav"
},
"AdditionalParameters": "{\"lyrics\":\"City lights fade, we find our way\"}"
}Prompt to song (easy_song_9.5) โ
Describe the song in Prompt only; the model writes the lyrics. No AdditionalParameters.lyrics.
{
"ModelName": "Mureka",
"ModelVersion": "easy_song_9.5",
"Prompt": "A bright summer love song with a catchy chorus",
"SubAppId": 123456789,
"OutputConfig": {
"StorageMode": "Temporary",
"OutputAudioFormat": "mp3"
}
}Instrumental (instrumental_9.5) โ
{
"ModelName": "Mureka",
"ModelVersion": "instrumental_9.5",
"Prompt": "A quiet electronic instrumental for a night drive, slow tempo, warm pads",
"SubAppId": 123456789,
"OutputConfig": {
"StorageMode": "Permanent",
"OutputAudioFormat": "flac"
}
}Response Example โ
{
"Response": {
"TaskId": "<task-id>",
"RequestId": "<request-id>"
}
}Query the completion result with DescribeTaskDetail. See Audio Result Structure.
Special Settings โ
- Lyrics are specified in the
AdditionalParametersJSON string'slyrics, and only apply tosong_8/song_9/song_9.5. Do not confuse this with MPS MiniMaxMusic'slyricfield. AdditionalParametersis a JSON string, so the inner quotes must be escaped ("{\"lyrics\":\"...\"}").- Output formats are
mp3/wav/flac. - Prompt length (reference values from the upstream Mureka API, not stated in the VOD guide): prompt to song up to
2000characters, instrumental up to1024characters.