如果你的产品允许用户上传歌曲,可以让他们用同一份音频试不同风格的编曲和演唱。接入 Mureka Remix API 时,服务端保存一个音频标识,按改编方向提交任务,再查询任务状态,将完成的版本交给播放器。

接入方式

项说明
接口POST /v1/song/remix
模型参数model=mureka-9.5
音频来源两种都支持:① 上传自己的音频(先调文件上传接口,purpose=remix,拿到 upload_audio_id);② 传 Mureka 近一个月生成的歌曲 song_id
时长10 – 480 秒
每次生成数量n 默认 2,最多 3
价格海外 $0.5 / 首,国内 ¥3 / 首(旧版 V8 价格不变:$0.2 / ¥1.5)
文档海外接口文档;国内 platform.mureka.cn 同路径

效果说明:生成结果是对原曲的重新演绎,不会保留原唱的音色;暂不支持指定某位歌手的音色,也不支持额外上传音频作为风格参考。

模型选择:在请求中将 model 设为 mureka-9.5 可使用 Remix V9.5,设为 mureka-8 可使用 V8。

适用场景

  • 翻唱 / 改编类 App:用户上传一段清唱,生成完整编曲的多个风格版本
  • 短视频与内容平台:同一首 BGM 快速出摇滚、电子、爵士等多个版本,匹配不同画面情绪
  • 音乐人与制作工具:把 demo 小样(弹唱、哼唱)快速扩展成完整编曲,做风格探索
  • 游戏 / 广告配乐:同一主题旋律按场景出不同强度的变奏(参考 Demo B 的情绪梯度)

调用流程

准备原始音频

本例使用一段有演唱的歌曲音频。上传时调用 POST /v1/files/upload,将 purpose 设为 remix,记录上传返回的文件 ID。V9.5 的 Remix 上传支持 MP3、M4A,音频时长为 10–480 秒。API Key 由服务端保存,通过 Bearer 鉴权调用。

curl --fail-with-body https://api.mureka.ai/v1/files/upload \
  -H "Authorization: Bearer ${MUREKA_API_KEY}" \
  -F "purpose=remix" \
  -F "file=@./original.mp3"

如果音频来自 Mureka 歌曲生成接口,也可以按接口支持范围使用对应的 song_id。一次请求选一种输入路径,上传文件用 upload_audio_id,已有歌曲用 song_id。两条路径的素材限制以接口文档为准。

为一个改编方向提交任务

向 POST /v1/song/remix 提交上传 ID 和描述目标风格的 prompt。本例显式指定 mureka-9.5,并以有演唱的摇滚改编为例。请将占位值换成上传返回的 ID 和实际要演唱的歌词。

curl --fail-with-body https://api.mureka.ai/v1/song/remix \
  -H "Authorization: Bearer ${MUREKA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "upload_audio_id": "<UPLOAD_AUDIO_ID>",
    "model": "mureka-9.5",
    "lyrics": "<LYRICS_FOR_THIS_VERSION>",
    "prompt": "Keep the chorus melody. Use distorted guitars and live rock drums, with a restrained verse and a bigger chorus.",
    "n": 1
  }'

同一个 prompt 可以通过 n 请求多个候选。要让用户分别选择摇滚、EDM 和女生版,可以复用同一个上传 ID,分别提交三条请求,各自写明目标方向。每个任务在应用内关联原始音频 ID、版本备注和任务 ID,方便结果回来后准确归位。

查询任务并展示试听结果

提交请求后,保存返回的任务 ID,调用 GET /v1/song/query/{task_id} 查询状态。任务仍在生成时,应用可以显示等待状态并继续查询。成功后读取返回的音频地址供试听,失败时记录任务 ID 和错误信息,便于排查。

curl --fail-with-body \
  "https://api.mureka.ai/v1/song/query/${TASK_ID}" \
  -H "Authorization: Bearer ${MUREKA_API_KEY}"

在试听页里,原曲和改编音频可以使用同一个歌曲名,靠版本备注区分原曲与改编结果。这样用户切换版本时,既能找回原曲,也能知道自己正在听哪一种演绎。

附件:接入文档 鉴权与快速开始 · 上传音频 · Remix 接口 · 查询任务