如果產品允許使用者上傳歌曲,就能讓他們用同一份音訊嘗試不同的編曲和唱法。串接 Mureka Remix API 時,由伺服器儲存音訊 ID,依改編方向提交任務,接著查詢狀態,把完成的版本交給播放器。

串接方式

項目

說明

介面

POST /v1/song/remix

模型參數

model=mureka-9.5

音訊來源

上傳音訊時設定 purpose=remix,取得 upload_audio_id,或提供近一個月內由 Mureka 生成的歌曲 song_id。

長度

10–480 s

每次生成數量

n 預設為 2,最多 3

價格

海外 $0.5 / 首,國內 ¥3 / 首(舊版 V8 價格不變:$0.2 / ¥1.5)

文件

Mureka API (.ai) · Mureka API (.cn)

效果說明:生成結果是對原曲的重新演繹,無法保留原唱的音色。目前也無法指定特定歌手的音色,或另外上傳音訊作為風格參考。

模型選擇:在請求中將 model 設為 mureka-9.5 即可使用 Remix V9.5,設為 mureka-8 則使用 V8。

適用情境

  • 翻唱或改編 App:使用者上傳一段清唱,即可製作多種曲風的完整編曲版本。
  • 短影音與內容平台:把同一首背景音樂快速改成搖滾、電子或爵士等版本,搭配不同畫面情緒。
  • 音樂人與製作工具:將彈唱或哼唱的 demo 快速擴展為完整編曲,探索不同曲風。
  • 遊戲與廣告配樂:依場景將同一主題旋律改為不同強度的變奏,參考 Demo B。

呼叫流程

準備原始音訊

本例使用含人聲的歌曲音訊。呼叫 POST /v1/files/upload,將 purpose 設為 remix,並記下回傳的檔案 ID。V9.5 支援 MP3、M4A,長度為 10–480 秒。API 金鑰儲存在伺服器,並使用 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 歌曲生成 API 建立,也可使用符合條件的 song_id。每次請求擇一:上傳檔案用 upload_audio_id,現有歌曲用 song_id。兩種方式的素材限制請參閱介面文件。

依一種改編方向提交任務

將上傳 ID 與描述目標曲風的 prompt 送至 POST /v1/song/remix。本例指定 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}"

試聽頁可為原曲和改編版本使用同一歌名,再用版本標籤區分。使用者切換時就能找回原曲,也能辨識當前版本。

串接文件