人聲去除 API
介面說明
人聲去除用於把一首既有歌曲拆成人聲與伴奏兩條軌道，是「分軌（人聲伴奏分離）」的快捷形式：
呼叫方只需要給一個來源歌曲 ID，不需要選擇分離模式，服務端固定按兩軌（two）處理。
介面位址：POST /api/music/vocal-removal
計費：免費。該介面只做軌道拆分，不產生生成費用，也不寫扣費流水。
推薦模型：suno-v6。可用 suno-v6、suno-v6-wild 或 suno-v6-mini。
驗證
| 參數名 | 型別 | 必填 | 說明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | application/json |
請求參數
| 參數名 | 型別 | 必填 | 預設值 | 說明 |
|---|---|---|---|---|
| model | string | 是 | - | 對客模型名：suno-v6、suno-v6-wild 或 suno-v6-mini |
| source_clip_id | string | 是 | - | 來源歌曲的真實 song_id，必須已完成且目前 API Key 可存取 |
| source_audio_url | string | 否 | - | 來源音訊位址（來源跨帳號時由服務端做中轉，用戶端不需要傳） |
| source_file_name | string | 否 | - | 來源檔案名，僅用於日誌與顯示 |
| song_title | string | 否 | - | 結果標題前綴，預設沿用來源歌曲標題 |
相容別名：sourceClipId、audio_id、audioId、song_id 都可以代替
source_clip_id。
請求範例
curl -X POST https://www.suno-api.io/api/music/vocal-removal \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"source_clip_id": "source_song_id",
"song_title": "人聲去除"
}'
回應結果
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "vocals_clip_id",
"song_title": "人聲去除 (Vocals)",
"status": "pending",
"stem_from_id": "source_song_id",
"stem_mode": "two"
},
{
"song_id": "instrumental_clip_id",
"song_title": "人聲去除 (Instrumental)",
"status": "pending",
"stem_from_id": "source_song_id",
"stem_mode": "two"
}
]
}
}
平台一次提交會返回 2 個版本 × {Vocals, Instrumental}，因此 clips 通常有 4 條。
請按 stem_from_id 分組、按 song_title 後綴區分人聲與伴奏。
注意事項
- 結果軌道請用歌曲查詢 API（
POST /api/music/query）輪詢到completed後再使用；GET /api/music/songs/:song_id與歌曲歷史清單目前不包含 人聲去除產出的軌道，這是已知差異。 - 需要選擇兩軌/多軌模式、或按軌道名自訂拆分時，請使用 分軌（人聲伴奏分離）API。
- 不需要的軌道可以用分軌刪除 API隱藏，不要重複提交刪除請求。