分軌刪除 API
介面說明
分軌刪除用於把已經生成的分軌軌道從清單裡隱藏。刪除是軟刪除：後端只給分軌列打
stem_hidden 標記，底層音訊、MIDI 與下載資源都保留，同一首歌之後仍可以再次分離出新的分軌。
介面位址：POST /api/music/stem-delete
計費：免費。刪除只更新平台內的可見狀態，不呼叫 Suno，也不產生扣費。
推薦模型：suno-v6。可用 suno-v6、suno-v6-wild 或 suno-v6-mini。
驗證
| 參數名 | 型別 | 必填 | 說明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | application/json |
請求參數
| 參數名 | 型別 | 必填 | 預設值 | 說明 |
|---|---|---|---|---|
| song_id | string | 否 | - | 單條分軌軌道的 song_id（/api/music/separate 回傳的軌道 ID） |
| song_ids | string[] | 否 | - | 批次寫法，一次最多 100 條 |
| stem_batch_id | string | 否 | - | 依批次刪除：刪掉這批自動分軌的全部軌道 |
| stem_mode | string | 否 | - | 依模式刪除：例如 two、twelve |
song_id / song_ids / stem_batch_id / stem_mode 至少要提供一個，否則回傳 400。
請求範例
curl -X POST https://www.suno-api.io/api/music/stem-delete \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"song_ids": ["stem_track_id_1", "stem_track_id_2"]
}'
回應結果
{
"code": 200,
"message": "success",
"data": {
"hidden": 2,
"affected_sources": 1
}
}
| 欄位 | 型別 | 說明 |
|---|---|---|
| hidden | number | 本次隱藏的軌道條數 |
| affected_sources | number | 受影響的來源歌曲數量 |
注意事項
- 冪等：軌道已隱藏或 ID 不存在時回傳
hidden: 0，不會報錯，重複呼叫安全。 - 刪除只影響目前 API Key 所屬的歌曲；不屬於自己的軌道不會被改動。
- 清單裡最後一條可見分軌被隱藏後，來源歌曲的「已分軌」標記會隨之清除。