Stem delete API
Endpoint description
Stem delete hides already-generated stem tracks from the list. The deletion is a soft delete: the backend only marks the stem rows with
stem_hidden; the underlying audio, MIDI and download resources are kept, and the same song can still be separated into new stems later.
Endpoint: POST /api/music/stem-delete
Billing: Free. The deletion only updates visibility inside the platform; it does not call Suno and produces no charge.
Recommended model: suno-v6. suno-v6, suno-v6-wild and suno-v6-mini are available.
Authentication
| Parameter | Type | Required | Notes |
|---|---|---|---|
| Authorization | string | yes | Bearer YOUR_API_KEY |
| Content-Type | string | yes | application/json |
Request parameters
| Parameter | Type | Required | Default | Notes |
|---|---|---|---|---|
| song_id | string | no | - | song_id of a single stem track (the track ID returned by /api/music/separate) |
| song_ids | string[] | no | - | Batch form, at most 100 per call |
| stem_batch_id | string | no | - | Delete by batch: removes every track of that automatic separation batch |
| stem_mode | string | no | - | Delete by mode, for example two, twelve |
At least one of song_id / song_ids / stem_batch_id / stem_mode must be provided, otherwise the response is 400.
Request example
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"]
}'
Response
{
"code": 200,
"message": "success",
"data": {
"hidden": 2,
"affected_sources": 1
}
}
| Field | Type | Notes |
|---|---|---|
| hidden | number | Number of tracks hidden by this call |
| affected_sources | number | Number of source songs affected |
Notes
- Idempotent: when a track is already hidden or the ID does not exist, the response is
hidden: 0with no error, so repeating the call is safe. - Deletion only affects songs belonging to the current API key; tracks that are not yours are left untouched.
- Once the last visible stem in the list is hidden, the source song's "separated" flag is cleared along with it.
Get an API key
Create an API key in the console after signing up. ¥0.6 per run returns 2 tracks, downloads are unlimited, and no phone number is required.
Get API key Back to overview