API zum Löschen von Stems

Aktualisiert am 2026-09-18 · Suno-API-Team

Beschreibung des Endpunkts

Das Löschen von Stems blendet bereits erzeugte Stem-Spuren aus der Liste aus. Das Löschen ist ein Soft Delete: Das Backend markiert die Stem-Zeilen nur mit stem_hidden; die zugrunde liegenden Audio-, MIDI- und Download-Ressourcen bleiben erhalten, und derselbe Song kann später erneut in neue Stems getrennt werden.

Endpunkt: POST /api/music/stem-delete

Abrechnung: Kostenlos. Das Löschen aktualisiert nur die Sichtbarkeit innerhalb der Plattform; es ruft Suno nicht auf und verursacht keine Kosten.

Empfohlenes Modell: suno-v6. Verfügbar sind suno-v6, suno-v6-wild und suno-v6-mini.

Authentifizierung

Anfrageparameter

Mindestens eines von song_id / song_ids / stem_batch_id / stem_mode muss angegeben werden, sonst kommt 400.

Beispielanfrage

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

Antwort

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

Hinweise

• Idempotent: ist die Spur bereits ausgeblendet oder existiert die ID nicht, kommt hidden: 0 ohne Fehler; ein Wiederholen ist also sicher.
• Das Löschen betrifft nur Songs des aktuellen API-Schlüssels; Spuren, die Ihnen nicht gehören, bleiben unberührt.
• Sobald der letzte sichtbare Stem der Liste ausgeblendet wird, wird auch die Markierung „getrennt" des Quellsongs entfernt.