Mureka 音乐生成

基础信息

• 基础域名：https://api.apiverse.ai
• 鉴权方式：Authorization: Bearer <API_KEY>
• Content-Type：application/json
• 路由前缀：/api/v2/open/aigc/mureka

所有 Mureka 接口均通过上述路由前缀访问，路径与请求体字段原样透传：在官方 Mureka 路径前拼接路由前缀即可（例如官方 /v1/song/generate → /api/v2/open/aigc/mureka/v1/song/generate）。请求体、查询参数按原字段转发，不裁剪可选参数；响应保持原始 JSON 结构。

迁移提示：若你已有 Mureka SDK / 调用代码，只需把 baseUrl 从官方地址改为 https://api.apiverse.ai/api/v2/open/aigc/mureka，鉴权头替换为本平台 API Key，其余路径和参数不变。

接口能力概览

接口分为三类，计费与查询方式不同：

• 同步接口：请求即时返回结果，无需轮询（歌词生成、歌词续写、歌曲识别、歌曲理解、音色克隆、语音合成、播客语音）。
• 异步接口：请求返回任务 id，需用对应的查询接口轮询结果（歌曲生成、纯音乐、配乐、续写、混音、局部编辑、单轨、分轨、转谱、歌词视频）。
• 上传接口：用于上传参考音频/图片/视频等素材，返回素材 ID 供其它接口引用，免费透传。

快速示例

生成歌曲（异步）

curl -X POST "https://api.apiverse.ai/api/v2/open/aigc/mureka/v1/song/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_KEY>" \
  -d '{
    "lyrics": "[Verse]\n咸咸的风 吹乱了头发\n[Chorus]\n在夏天 还是会想你",
    "model": "auto",
    "prompt": "pop, sad, summer",
    "n": 2
  }'

返回任务 id：

{
  "id": "1523127798xxxxx",
  "created_at": 1785306793,
  "model": "mureka-9",
  "status": "preparing",
  "trace_id": "xxxxxxxx"
}

查询歌曲任务（轮询）

curl "https://api.apiverse.ai/api/v2/open/aigc/mureka/v1/song/query/1523127798xxxxx" \
  -H "Authorization: Bearer <API_KEY>"

生成完成后返回 status: succeeded 及结果列表：

{
  "id": "1523127798xxxxx",
  "created_at": 1785306793,
  "finished_at": 1785306839,
  "model": "mureka-9",
  "status": "succeeded",
  "choices": [
    {
      "id": "1523128698xxxxx",
      "url": "https://cdn.example.com/song/xxxxx.mp3",
      "flac_url": "https://cdn.example.com/song/xxxxx.flac",
      "duration": 128000
    }
  ],
  "trace_id": "xxxxxxxx"
}

⚠️ 关于 song_id：续写、混音、局部编辑、单轨、转谱等接口的 song_id 参数，需填查询结果 choices[].id（每首歌各自的 id），不是外层任务 id。填错会返回 The corresponding song is not found。

生成歌词（同步）

curl -X POST "https://api.apiverse.ai/api/v2/open/aigc/mureka/v1/lyrics/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_KEY>" \
  -d '{ "prompt": "夏天的海边，思念一个人" }'

即时返回标题与歌词：

{
  "title": "夏日海岸的想念",
  "lyrics": "[Verse]\n咸咸的风 吹乱了头发\n...",
  "trace_id": "xxxxxxxx"
}

接口列表

异步接口（需轮询查询）

查询接口

歌曲类异步接口（生成/续写/混音/编辑/单轨/分轨/转谱/配乐/歌词视频）统一走「歌曲任务查询」，纯音乐接口走「纯音乐查询」。{task_id} 为创建接口返回的 id。

同步接口（即时返回）

上传接口（免费透传）

参数说明

1. 歌曲生成

POST /v1/song/generate

2. 一句话生成

POST /v1/song/easy-generate

3. 纯音乐生成

POST /v1/instrumental/generate

纯音乐任务需用「纯音乐查询」接口轮询结果。

4. 配乐生成

POST /v1/soundtrack/generate

为图片或视频生成配乐。

5. 歌曲续写

POST /v1/song/extend

6. 歌曲混音

POST /v1/song/remix

7. 局部编辑

POST /v1/song/region-edit

对歌曲指定区间重写。

8. 单轨生成

POST /v1/track/generate

为歌曲生成指定类型的单轨。

9. 歌曲分轨

POST /v1/song/stem

将歌曲分离为独立音轨。

10. 音乐转谱

POST /v1/song/transcribe

11. 歌词视频

POST /v1/lyrics-video/generate

12. 歌词生成（同步）

POST /v1/lyrics/generate

13. 歌词续写（同步）

POST /v1/lyrics/extend

14. 歌曲识别（同步）

POST /v1/song/recognize

15. 歌曲理解（同步）

POST /v1/song/describe

分析歌曲风格、情绪等信息。

16. 音色克隆（同步）

POST /v1/song/vocal-clone

上传音频进行音色克隆，返回音色 ID 供歌曲生成引用。

17. 语音合成 TTS（同步）

POST /v1/tts/generate

18. 播客语音（同步）

POST /v1/tts/podcast

多角色对话式语音合成。

请求示例：

{
  "conversations": [
    { "text": "大家好，欢迎收听本期节目。", "voice": "Ethan" },
    { "text": "今天我们聊聊夏天的海边。", "voice": "Victoria" }
  ]
}

19. 素材上传

POST /v1/files/upload（multipart/form-data）

上传参考音频/图片/视频等素材，返回素材 ID 供其它接口通过 reference_id / vocal_id / image_id / upload_audio_id 等字段引用。大文件可使用分片上传接口（/v1/uploads/create → /v1/uploads/add → /v1/uploads/complete）。

任务状态说明

异步任务查询返回的 status 取值：

任务失败（failed / timeouted / cancelled）时，本次调用产生的费用将自动退回。

轮询与处理时间建议

歌曲/纯音乐等为异步任务，建议轮询间隔：

• 前 30 秒：每 5 秒查询一次
• 30 秒 ~ 2 分钟：每 10 秒查询一次
• 2 分钟后：每 15 秒查询一次

处理时间参考：

• 歌词生成 / 续写：通常 3 ~ 10 秒（同步返回）
• 歌曲 / 纯音乐 / 配乐生成：通常 30 秒 ~ 2 分钟
• 音色克隆 / 歌曲分轨：通常 10 ~ 30 秒

模型说明

错误码

接口正常时响应保持上游原始 JSON 结构；网关层错误（如路径不支持、余额不足）返回统一结构：

{
  "code": 40001,
  "msg": "insufficient balance",
  "data": null
}