API voor het verwijderen van stems

Bijgewerkt op 2026-09-18 · Suno-API-team

Beschrijving van het endpoint

Het verwijderen van stems verbergt al gegenereerde stemsporen uit de lijst. Het verwijderen is soft delete: de backend markeert de stemrijen alleen met stem_hidden; de onderliggende audio, MIDI en downloadbronnen blijven bewaard, en hetzelfde nummer kan later opnieuw in nieuwe stems worden gesplitst.

Endpoint: POST /api/music/stem-delete

Facturering: Gratis. Het verwijderen werkt alleen de zichtbaarheid binnen het platform bij; het roept Suno niet aan en levert geen kosten op.

Aanbevolen model: suno-v6. Beschikbaar zijn suno-v6, suno-v6-wild en suno-v6-mini.

Authenticatie

Verzoekparameters

Er moet minimaal één van song_id / song_ids / stem_batch_id / stem_mode worden meegegeven, anders volgt 400.

Voorbeeldverzoek

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

Antwoord

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

Opmerkingen

• Idempotent: is het spoor al verborgen of bestaat de ID niet, dan volgt hidden: 0 zonder fout, dus herhalen is veilig.
• Verwijderen raakt alleen nummers van de huidige API-sleutel; sporen die niet van u zijn blijven onaangeroerd.
• Zodra het laatste zichtbare stem in de lijst wordt verborgen, wordt ook de markering "gescheiden" van het bronnummer gewist.