MaaS_Mureka音乐模型接口文档

请求协议

Http

Header

参数名	值
Authorization	Bearer {YOUR AK}
Content-Type	application/json

请求url

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

请求Body

生成歌曲

字段	类型	必填	说明
lyrics	string	是	歌词内容 (必须)
model	string	否	模型版本,可选：MaaS_Mureka_o1_generate、MaaS_Mureka_v7.5_ generate
n	int	否	每次请求生成的歌曲数量，最大值为 3，缺省为 2
prompt	string	否	歌曲提示词
reference_id	string	否	参考音乐 ID，由上传文件接口（ files/upload API） 生成（purpose: reference）
vocal_id	string	否	音色 ID，由上传文件接口（ files/upload API） 生成（purpose: vocal）
melody_id	string	否	旋律 ID，由上传文件接口（ files/upload API） 生成（purpose: melody）
instrumental_id	string	否	纯音乐参考 ID，由上传文件接口（ files/upload API）生成（purpose: instrumental）

请求示例

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】\n青春如花绽放\n梦想在心中飞翔\n\n【Chorus】\n青春与梦想\n永远在心中",
  "model": MaaS_Mureka_v7.5_ generate",
  "n": 1,
  "prompt": "创作一首关于青春梦想的流行歌曲"
}'

查询任务（歌曲）

请求示例

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}'

生成纯音乐

字段	类型	必填	说明
model	string	否	要使用的模型。使用 auto 选择常规模型的最新版。可选：MaaS_Mureka_v7.5_ generate
n	int	否	每次请求生成的纯音乐数量，最大值为3，缺省为2. 注意会根据数量计费。
prompt	string	否	通过输入提示词控制纯音乐的生成，最大1024个字符。选择此选项时，其他控制选项（instrumental_id）不能选择。
instrumental_id	string	否	通过参考音乐控制纯音乐的生成，由files/upload API生成（purpose: instrumental）。选择此选项时，其他控制选项（prompt）不能选择。

请求示例

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": "创作一首宁静的钢琴背景音乐，适合冥想和放松",
  "model": "MaaS_Mureka_v7.5_ generate"
}'

查询任务（纯音乐）

请求示例

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}'

上传文件

字段	类型	必填	说明
file	file	是	要上传的文件内容
purpose	string	是	文件用途。有效取值: reference, vocal, melody, instrumental, voice, audio

请求示例

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"'