MaaS_Mureka API

以下文档仅适用于MaaS_Mureka_o1、MaaS_Mureka_v7.5模型。若要了解MaaS_Mureka_o2 、MaaS_Mureka_v7.6 模型接口文档请参考：MaaS_Mureka_v7.6

请求协议

Http

Header

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

生成歌曲

请求url

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

请求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）
stream	boolean	否	如果设置为 true，生成任务的状态将包含一个流式传输阶段。 在此阶段，您可以获取已生成歌曲的 stream_url 并播放该 URL，从而实现在生成过程中播放歌曲。 当模型为 mureka-o1 时，不支持此模式

请求示例

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

查询任务（歌曲）

请求示例

curl 'https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/song/query/{task_id}' \
-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）不能选择。
stream	boolean	否	如果设置为 true，生成任务的状态将包含一个流式传输阶段。 在此阶段，您可以获取已生成歌曲的 stream_url 并播放该 URL，从而实现在生成过程中播放歌曲。 当模型为 mureka-o1 时，不支持此模式

请求示例

curl 'https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/instrumental/generate' \
-H 'Authorization:  Bearer ${Your AK}' \
-H 'Content-Type:  application/json' \
-d '{
  "prompt": "创作一首宁静的钢琴背景音乐，适合冥想和放松",
  "model": "MaaS_Mureka_v7.5_generate"
}'

查询任务（纯音乐）

请求示例

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

上传文件

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

请求示例

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