MaaS_Mureka音乐模型

更新日志：新增 MaaS_Mureka_v9 模型支持，纯音乐生成接口新增 v8/v9 模型

通用说明

请求协议

协议：HTTP
Header：

参数名	值
Authorization	Bearer
Content-Type	application/json

1️⃣ 文件上传

接口信息

方法：POST
URL：https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/files/upload
编码：multipart/form-data

请求参数

字段	类型	必填	说明
file	file	是	要上传的文件内容
purpose	string	是	文件用途（见下表）

purpose 取值说明

用途	说明	格式要求	时长要求
`reference`	参考音乐	mp3, m4a	30秒（超出裁剪）
`vocal`	人声音色	mp3, m4a	15-30秒（超出裁剪）
`melody`	旋律	mp3, m4a, mid	5-60秒（超出裁剪）
`instrumental`	纯音乐参考	mp3, m4a	30秒（超出裁剪）
`voice`	声音	mp3, m4a	5-15秒（超出裁剪）
`audio`	通用音频	mp3, m4a	用于歌曲扩展等

请求示例

curl 'https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/files/upload' \
-H 'Authorization: Bearer ${Your AK}' \
-F 'file=@"/path/to/your/music.mp3"' \
-F 'purpose="audio"'

响应参数

字段	类型	说明
id	string	文件标识符，用于后续API引用
bytes	integer	文件大小（字节）
created_at	integer	创建时间戳（秒）
filename	string	文件名称
purpose	string	文件用途

响应示例

{
    "trace_id": "b4f3edecf8288f19652102e17eab3c91",
    "id": "114045503930371",
    "bytes": 3637542,
    "created_at": 1767059534,
    "filename": "music.mp3",
    "purpose": "audio"
}

2️⃣ 生成歌曲

接口信息

方法：POST
URL：https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/song/generate

请求参数

字段	类型	必填	说明
lyrics	string	✅ 是	歌词内容
model	string	否	模型版本：`MaaS_Mureka_v7.5_generate`、`MaaS_Mureka_v9`、`MaaS_Mureka_o1_generate`
n	int	否	生成数量，最大3，默认2
prompt	string	否	歌曲提示词，最多1024字符。选择后其他控制选项失效
reference_id	string	否	参考音乐ID（purpose: reference）。选择后prompt、melody_id失效
vocal_id	string	否	音色ID（purpose: vocal）。选择后prompt、melody_id失效
melody_id	string	否	旋律ID（purpose: melody）。选择后prompt、reference_id、vocal_id失效
instrumental_id	string	否	纯音乐参考ID（purpose: instrumental）
stream	boolean	否	是否流式传输。true时可边生成边播放。o1模型不支持

请求示例

使用 v9 模型（推荐）

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_v9",
  "n": 1,
  "stream": true,
  "prompt": "创作一首关于青春梦想的流行歌曲"
}'

使用 v7.5 模型

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梦想在心中飞翔",
  "model": "MaaS_Mureka_v7.5_generate",
  "n": 1,
  "prompt": "流行歌曲风格"
}'

响应参数

字段	类型	说明
taskId	string	异步任务ID
created_at	integer	创建时间戳（秒）
finished_at	integer	完成时间戳（秒）
model	string	使用的模型
status	string	状态：preparing, queued, running, streaming, succeeded, failed, timeouted, cancelled
failed_reason	string	失败原因

响应示例

{
    "code": 0,
    "data": {
        "taskId": "113923099721729",
        "created_at": 1767001167,
        "finished_at": null,
        "model": "MaaS_Mureka_v9",
        "status": "preparing",
        "failed_reason": null
    },
    "code_msg": "success",
    "trace_id": "eb174f86b6c59ba838ce4401b01678eb"
}

3️⃣ 生成纯音乐

接口信息

方法：POST
URL：https://genaiapi.cloudsway.net/v1/ai/${Yourendpoint}/mureka/instrumental/generate

请求参数

字段	类型	必填	说明
model	string	否	模型版本：`MaaS_Mureka_v7.5_generate`、`MaaS_Mureka_v8`、`MaaS_Mureka_v9`，使用 `auto` 选择最新版
n	int	否	生成数量，最大3，默认2
prompt	string	否	提示词控制纯音乐生成，最大1024字符。选择后instrumental_id失效
instrumental_id	string	否	参考音乐ID（purpose: instrumental）。选择后prompt失效
stream	boolean	否	是否流式传输。v7.5/v8/v9 均支持流式

模型版本特性对比

模型	音乐质量	生成速度	风格多样性	流式支持
MaaS_Mureka_v7.5_generate	标准	快	中等	✅
MaaS_Mureka_v8	较高	中等	丰富	✅
MaaS_Mureka_v9	最高	中等	最丰富	✅

请求示例

使用 v9 模型（推荐）

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_v9",
  "n": 1,
  "stream": true
}'

使用 v8 模型

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_v8",
  "n": 1
}'

使用参考音乐（v9模型）

curl 'https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/instrumental/generate' \
-H 'Authorization: Bearer ${Your AK}' \
-H 'Content-Type: application/json' \
-d '{
  "instrumental_id": "114045503930371",
  "model": "MaaS_Mureka_v9",
  "n": 1
}'

响应参数

与生成歌曲接口相同，返回 taskId 用于查询。

{
    "code": 0,
    "data": {
        "taskId": "113923099721730",
        "created_at": 1767001167,
        "model": "MaaS_Mureka_v9",
        "status": "preparing"
    },
    "code_msg": "success"
}

4️⃣ 续写歌曲

接口信息

方法：POST
URL：https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/song/extend

请求参数

字段	类型	必填	说明
song_id	string	否	要扩展的歌曲ID（由song/generate生成）。与upload_audio_id互斥
upload_audio_id	string	否	参考音乐ID（purpose: reference）。与song_id互斥
lyrics	string	✅ 是	续写的歌词内容
extend_at	string	✅ 是	延长开始时间（毫秒），有效范围 [8000, 420000]。若大于歌曲时长则默认为歌曲时长

注意：续写功能仅支持歌曲，不支持纯音乐。续写使用的模型与原歌曲生成时使用的模型一致。

请求示例

curl 'https://genaiapi.cloudsway.net/v1/ai/${Your endpoint}/mureka/song/extend' \
-H 'Authorization: Bearer ${Your AK}' \
-H 'Content-Type: application/json' \
-d '{
  "song_id": "113875917733890",
  "extend_at": "8000",
  "lyrics": "[Verse]\nIn the stormy night, I wander alone\nLost in the rain, feeling like I have been thrown"
}'

响应参数

与生成歌曲接口相同，返回 taskId。

{
    "code": 0,
    "data": {
        "taskId": "113893286346753",
        "created_at": 1767001167,
        "model": "MaaS_Mureka_v9",
        "status": "preparing"
    },
    "code_msg": "success"
}

5️⃣ 查询任务

接口信息

任务类型	查询URL
歌曲任务	`/mureka/song/query/{task_id}`
纯音乐任务	`/mureka/instrumental/query/{task_id}`

方法：GET

请求示例

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

响应参数

字段	类型	说明
taskId	string	任务ID
status	string	任务状态
finished_at	integer	完成时间戳
choices	array	生成结果列表

choices 字段说明

字段	类型	说明
id	string	生成歌曲/纯音乐的ID
url	string	音频URL（MP3），有效期1个月
wav_url	string	WAV无损格式URL
flac_url	string	FLAC无损格式URL
stream_url	string	流式播放URL（仅stream=true时）
duration	integer	时长（毫秒）
lyrics_sections	array	歌词分段信息（仅歌曲）

lyrics_sections 结构

字段	说明
section_type	分段类型：intro, verse, pre-chorus, chorus, bridge, break, outro
start/end	分段起止时间（毫秒）
lines	歌词行，包含start/end/text/words

响应示例（歌曲任务-成功）

{
    "code": 0,
    "data": {
        "taskId": "113905426890753",
        "created_at": 1766992740,
        "finished_at": 1766992759,
        "model": "MaaS_Mureka_v9",
        "status": "succeeded",
        "failed_reason": null,
        "choices": [
            {
                "id": "113905464770561",
                "url": "https://cdn.mureka.ai/.../song.mp3",
                "wav_url": "https://cdn.mureka.ai/.../song.wav",
                "flac_url": "https://cdn.mureka.ai/.../song.flac",
                "duration": 41540,
                "lyrics_sections": [
                    {
                        "section_type": "intro",
                        "start": 2400,
                        "end": 2800,
                        "lines": [
                            {
                                "start": 2400,
                                "end": 2800,
                                "text": "Float song"
                            }
                        ]
                    }
                ]
            }
        ]
    },
    "code_msg": "success"
}

响应示例（纯音乐任务-成功）

{
    "code": 0,
    "data": {
        "taskId": "113905426890754",
        "created_at": 1766992740,
        "finished_at": 1766992759,
        "model": "MaaS_Mureka_v9",
        "status": "succeeded",
        "failed_reason": null,
        "choices": [
            {
                "id": "113905464770562",
                "url": "https://cdn.mureka.ai/.../instrumental.mp3",
                "wav_url": "https://cdn.mureka.ai/.../instrumental.wav",
                "flac_url": "https://cdn.mureka.ai/.../instrumental.flac",
                "duration": 120000
            }
        ]
    },
    "code_msg": "success"
}

文档更新日期：2026-04-29

最新更新：新增 MaaS_Mureka_v9 模型，纯音乐生成接口新增 v8/v9 模型支持