API för att ta bort stems

Uppdaterad 2026-09-18 · Suno-API-teamet

Beskrivning av ändpunkten

Att ta bort stems döljer redan genererade stemspår från listan. Borttagningen är en mjuk borttagning: backend markerar bara stemraderna med stem_hidden; själva ljudet, MIDI:n och nedladdningsresurserna behålls, och samma låt kan senare separeras igen till nya stems.

Ändpunkt: POST /api/music/stem-delete

Fakturering: Gratis. Borttagningen uppdaterar bara synligheten inom plattformen; den anropar inte Suno och ger inga kostnader.

Rekommenderad modell: suno-v6. suno-v6, suno-v6-wild och suno-v6-mini är tillgängliga.

Autentisering

Parameter	Typ	Krävs	Anmärkningar
Authorization	string	ja	`Bearer YOUR_API_KEY`
Content-Type	string	ja	`application/json`

Begäransparametrar

Parameter	Typ	Krävs	Standard	Anmärkningar
song_id	string	nej	-	`song_id` för ett enskilt stemspår (spår-ID:t som `/api/music/separate` returnerar)
song_ids	string[]	nej	-	Batchform, högst 100 per anrop
stem_batch_id	string	nej	-	Ta bort per batch: tar bort alla spår i den automatiska separeringsbatchen
stem_mode	string	nej	-	Ta bort per läge, till exempel `two`, `twelve`

Minst ett av song_id / song_ids / stem_batch_id / stem_mode måste anges, annars blir svaret 400.

Exempelbegäran

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"]
  }'

Svar

{
  "code": 200,
  "message": "success",
  "data": {
    "hidden": 2,
    "affected_sources": 1
  }
}

Fält	Typ	Anmärkningar
hidden	number	Antal spår som doldes av detta anrop
affected_sources	number	Antal berörda källlåtar

Noter

Idempotent: är spåret redan dolt eller finns inte ID:t blir svaret hidden: 0 utan fel, så att upprepa anropet är säkert.
Borttagningen påverkar bara låtar som tillhör den aktuella API-nyckeln; spår som inte är dina lämnas orörda.
När det sista synliga stemet i listan döljs rensas även källlåtens markering "separerad".

NästaAPI för att skapa/hämta WAV

Skaffa en API-nyckel

Skapa en API-nyckel i konsolen efter registreringen. Varje generering kostar 0,6 ¥ och returnerar 2 spår, nedladdningar är obegränsade och inget telefonnummer krävs.

Hämta API-nyckel Tillbaka till översikten