大模型服务平台 TokenHub Mureka 音乐生成

二、调用方式

音乐生成为同步调用：一次请求直接返回生成结果，无需创建任务和轮询。

三、前提条件

·已注册腾讯云账号并开通 TokenHub 服务。

·已在 TokenHub 控制台获取 API Key。

·在控制台-在线推理-语音模型处开启对应模型的后付费。

注意：说明：

注意：下文所有示例中的 YOUR_API_KEY 均需替换为你自己的 API Key，鉴权方式为请求头 Authorization: Bearer YOUR_API_KEY。

四、模型列表

模型名称	model 参数值	支持能力	歌词上限	提示词上限
Mureka-Music-v9	mureka-music-v9	歌词生成歌曲 / 提示词生成歌曲 / 生成纯音乐	5000 字符	提示词生成歌曲 2000 字符；歌词生成歌曲的风格提示词、纯音乐提示词 1024 字符

六、1. 接口描述

根据用户输入的歌词生成歌曲。传入完整歌词，可搭配风格提示词与人声性别倾向，模型据此完成作曲与演唱。

接口： POST https://tokenhub.tencentmaas.com/v1/wand/mureka-music/generation

七、2. 输入参数

参数名	必选	类型	描述
model	是	string	模型 ID。取值：mureka-music-v9
lyrics	是	string	歌词内容，长度 ≤ 5000 字符。支持使用分段标签组织歌曲结构：[Intro]、[Verse]、[Pre-Chorus]、[Chorus]、[Bridge]、[Outro]。
prompt	否	string	风格提示词，控制曲风、情绪、人声等（如 r&b, slow, passionate, male vocal），长度 ≤ 1024 字符。
gender	否	string	人声性别倾向。可选值：female、male。
n	否	integer	每次请求生成的歌曲数量，取值范围 [1, 3]，默认 1。

八、3. 请求示例

# 歌词生成歌曲curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/mureka-music/generation' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -H 'Content-Type: application/json' \\ -d '{ "model": "mureka-music-v9", "lyrics": "[Verse]\\nWalking through the city lights at midnight\\n[Chorus]\\nHold on to the memories", "prompt": "pop, emotional, female vocal, slow tempo", "gender": "female", "n": 1}'

九、4. 输出参数

字段	类型	说明
id	string	任务 ID。
created_at	integer	任务创建时间，Unix 时间戳，单位 s。
finished_at	integer	任务完成时间，Unix 时间戳，单位 s。
model	string	用于音乐生成的模型。
status	string	任务状态，枚举值：preparing（准备中）、queued（排队中）、running（生成中）、streaming（流式生成中）、reviewing（审核中）、succeeded（成功）、failed（失败）、timeouted（超时）、cancelled（已取消）。
failed_reason	string	任务失败原因，status 为 failed 时返回。
watermarked	boolean	是否在音乐尾部添加 5 秒水印音频，true 表示已添加。
choices	array[object]	生成结果列表，仅 status 为 succeeded 时返回；元素数量与请求的 n 一致。
choices[].url	string	生成音频的下载地址，为临时地址，请及时下载转存。
tokenhub_usage.total_tokens	integer	本次任务消耗的 token 数，用于计费/对账。
request_id	string	唯一请求标识，用于排查问题。

十、5. 响应示例

{ "id": "1256342408-WandAudio-c6313c32b0b74c648f401571c515be00", "created_at": 1790166087, "finished_at": 1790166137, "model": "mureka-9", "status": "succeeded", "choices": [ { "url": "https://xxxx.mp3", "flac_url": "https://xxxx.mp3", "duration": 162630, "lyrics_sections": [ { "section_type": "verse", "start": 12120, "end": 20240, "lines": [ { "start": 12120, "end": 20240, "text": "Walking through the city lights at midnight", "words": [ { "start": 12120, "end": 12200, "text": "Walking " }, { "start": 13160, "end": 13200, "text": "through " }, { "start": 13800, "end": 13840, "text": "the " }, { "start": 14120, "end": 14160, "text": "city " }, { "start": 14560, "end": 15560, "text": "lights " }, { "start": 18640, "end": 18680, "text": "at " }, { "start": 19040, "end": 20240, "text": "midnight" } ] } ] }, { "section_type": "chorus", "start": 38280, "end": 76800, "lines": [ { "start": 38280, "end": 76800, "text": "Hold on to the memories", "words": [ { "start": 38280, "end": 40520, "text": "Hold " }, { "start": 40920, "end": 40960, "text": "on " }, { "start": 55920, "end": 55960, "text": "to " }, { "start": 71800, "end": 71840, "text": "the " }, { "start": 74320, "end": 76800, "text": "memories" } ] } ] } ], "id": "162503562821633", "wav_url": "https://xxxx.mp3" } ], "trace_id": "4c0611edea3fc3493c82c3db7e71cb50", "watermarked": true, "tokenhub_usage": { "total_tokens": 33000 }, "request_id": "1019e5dc-a80b-43b7-9122-6a325d01ca97"}

十二、1. 接口描述

根据用户输入的提示词生成歌曲，可搭配风格枚举，无需自己写歌词，模型自动完成作词、作曲与演唱。

接口： POST https://tokenhub.tencentmaas.com/v1/wand/mureka-music/easy-generation

十三、2. 输入参数

参数名	必选	类型	描述
model	是	string	模型 ID。取值：mureka-music-v9
prompt	是	string	提示词，描述想要的歌曲内容、情绪与画面感，长度 ≤ 2000 字符。
styles	否	array[string]	风格列表，从枚举值中选择一个或多个风格：pop、rock、jazz、r&b、edm、ambient、folk、latin、k-pop、j-pop、house、gospel、lo-fi。
n	否	integer	每次请求生成的歌曲数量，取值范围 [1, 3]，默认 1。

十四、3. 请求示例

# 提示词生成歌曲curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/mureka-music/easy-generation' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -H 'Content-Type: application/json' \\ -d '{ "model": "mureka-music-v9", "prompt": "一首明亮夏日氛围、带有抓耳副歌的情歌", "styles": ["pop", "rock"], "n": 1}'

提交任务的输出参数与响应示例同歌词生成歌曲。

十六、1. 接口描述

根据用户输入的提示词生成无人声的纯音乐，适用于背景音乐、伴奏等场景。

接口： POST https://tokenhub.tencentmaas.com/v1/wand/mureka-music/instrumental-generation

十七、2. 输入参数

参数名	必选	类型	描述
model	是	string	模型 ID。取值：mureka-music-v9
prompt	是	string	提示词，描述想要的纯音乐风格与场景，长度 ≤ 1024 字符。
n	否	integer	每次请求生成的纯音乐数量，取值范围 [1, 3]，默认 1。

十八、3. 请求示例

# 生成纯音乐curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/mureka-music/instrumental-generation' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -H 'Content-Type: application/json' \\ -d '{ "model": "mureka-music-v9", "prompt": "lo-fi, cozy, warm piano and soft drums, late night study vibe", "n": 1}'

20、错误码说明

错误码	概述
400 – Invalid Request	原因：请求参数不正确。解决方案：请参考文档以输入正确的请求参数。
401 – Invalid Authentication	原因：认证无效。解决方案：请确保使用正确的 API 密钥。
403 – Forbidden	原因：你正在从不支持的地区访问 API。解决方案：请确保你的访问来自支持的地区。
429 – Rate limit reached for requests	原因：你发送请求的速度过快。解决方案：请控制请求速度，查看价格方案中的并发请求限制。
429 – You exceeded your current quota, please check your billing details	原因：你的充值已用完。解决方案：请充值。
451 – Unavailable For Legal Reasons	原因：请求参数没有通过安审。解决方案：请修改请求参数。
500 – The server had an error while processing your request	原因：我们的服务出现了问题。解决方案：稍后重试你的请求，如果问题仍然存在，请联系我们。
503 – The engine is currently overloaded, please try again later	原因：我们的服务负载过高。解决方案：请稍后重试你的请求。

22、1. 三种生成能力怎么区分？

三者请求 model 相同，但接口 path 不同，歌词生歌曲使用 /v1/wand/mureka-music/generation，提示词生歌曲使用 /v1/wand/mureka-music/easy-generation，生成纯音乐使用 /v1/wand/mureka-music/instrumental-generation。注意三者的提示词上限不同：提示词生成歌曲为 2000 字符，歌词生成歌曲的风格提示词与纯音乐提示词均为 1024 字符。

23、2. 默认生成几首？

n 参数默认为 1，且按生成数量计费。需要 3 首时，请在请求中显式传入 "n": 3；最多可传 3。

24、3. 歌词怎么写效果更好？

建议用分段标签组织歌词结构：[Intro]（前奏）、[Verse]（主歌）、[Pre-Chorus]（预副歌）、[Chorus]（副歌）、[Bridge]（桥段）、[Outro]（尾奏）。同时可用 prompt 补充曲风、情绪与人声描述（如 r&b, slow, passionate, male vocal），用 gender 指定人声性别倾向。

25、4. styles 和 prompt 有什么区别？

styles 是固定风格枚举（pop、rock、jazz 等 13 种），用于框定曲风大类，仅提示词生成歌曲支持；prompt 是自由文本，用于描述歌曲主题、情绪与画面感。两者可同时传入，由模型综合生效。

26、5. 生成结果有水印吗？

默认在音乐尾部添加 5 秒水印音频，查询结果中 watermarked 为 true 表示已添加。

27、6. 生成结果音频链接会过期吗？

会过期。choices[].url 为临时地址，存储 12 h，请在任务成功后及时下载转存，不要长期引用该链接。