如果產品允許使用者上傳歌曲,就能讓他們用同一份音訊嘗試不同的編曲和唱法。串接 Mureka Remix API 時,由伺服器儲存音訊 ID,依改編方向提交任務,接著查詢狀態,把完成的版本交給播放器。
串接方式
項目 | 說明 |
|---|---|
介面 |
|
模型參數 |
|
音訊來源 | 上傳音訊時設定 purpose=remix,取得 upload_audio_id,或提供近一個月內由 Mureka 生成的歌曲 song_id。 |
長度 | 10–480 s |
每次生成數量 | n 預設為 2,最多 3 |
價格 | 海外 $0.5 / 首,國內 ¥3 / 首(舊版 V8 價格不變:$0.2 / ¥1.5) |
文件 |
效果說明:生成結果是對原曲的重新演繹,無法保留原唱的音色。目前也無法指定特定歌手的音色,或另外上傳音訊作為風格參考。
模型選擇:在請求中將 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}"
試聽頁可為原曲和改編版本使用同一歌名,再用版本標籤區分。使用者切換時就能找回原曲,也能辨識當前版本。
串接文件