母帶重製 API（Remaster）
介面說明
母帶重製用於把一首已完成的歌曲重新生成一版音質更好的「重製版本」，一次返回 2 個版本，標題由上游自動追加 (Remastered)。
介面位址：POST /api/music/remaster
計費：收費，依請求模型計費（預設 suno-v6，0.6 元/次），實際扣費以後台價格設定為準。
模型說明：重製走上游獨立介面與獨立重製模型，由平台固定使用，不隨 model 變化；請求裡的 model 只用於計價與通路選擇，建議顯式傳入 suno-v6。
等待時間與逾時（重要）：本介面是同步介面，回應返回時才代表訂單已被受理並提交重製。請把用戶端逾時設為 300 秒以上；未收到回應不等於沒有重製，逾時後請勿立即重試（會重複下單、重複扣費）。連線中斷可稍後用
GET /api/music/songs確認。
驗證
| 參數名 | 型別 | 必填 | 說明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | application/json |
請求參數
| 參數名 | 型別 | 必填 | 預設值 | 說明 |
|---|---|---|---|---|
| song_id | string | 是 | - | 要重製的來源歌曲 ID，必須已完成且目前 API Key 可存取 |
| model | string | 否 | suno-v6 | 對客模型名：suno-v6、suno-v6-wild 或 suno-v6-mini，僅用於計價與通路 |
| variation_category | string | 否 | normal | 變體強度：subtle、normal、high（舊值 low 等價於 subtle） |
| style_profile | string | 否 | boost | 音色風格：natural、boost、clarity |
| tags | string | 否 | - | 預留欄位，非空時透傳給上游 |
| source_audio_url | string | 否 | - | 來源歌曲來自外部帳號時，來源音訊位址 |
| source_file_name | string | 否 | - | 來源歌曲來自外部帳號時，來源檔案名 |
| source_title | string | 否 | - | 來源歌曲來自外部帳號時，來源標題 |
audio_id、source_clip_id、sourceClipId 是 song_id 的等價寫法，任選一個即可。
請求範例
curl -X POST https://www.suno-api.io/api/music/remaster \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"song_id": "source_song_id",
"variation_category": "high",
"style_profile": "clarity"
}'
只要預設檔位時，只傳來源歌曲即可，等價於 variation_category: normal + style_profile: boost：
{ "model": "suno-v6", "song_id": "source_song_id" }
回應結果
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "remastered_clip_id_1",
"song_title": "來源歌名 (Remastered)",
"status": "processing"
},
{
"song_id": "remastered_clip_id_2",
"song_title": "來源歌名 (Remastered)",
"status": "processing"
}
]
}
}
一次返回 2 個重製版本。請保存兩條 clips[].song_id，再用歌曲查詢 API輪詢到 complete 後取音訊。
注意事項
- 來源歌曲必須已完成，並且屬於目前 API Key 可存取的範圍；外部來源素材會自動同步到執行帳號。
- 重製只做音質重製：想換風格、換編曲或換演唱，請用風格增強、上傳後翻唱或 Remix 類介面。
variation_category越大，重製版本與來源歌的差異越明顯；正式交付前建議用normal試一版再調高。