API zur Stimmenentfernung

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

Beschreibung des Endpunkts

Stimmenentfernung teilt einen bestehenden Song in zwei Spuren: Gesang und Begleitung. Es ist die Kurzform der Stem-Trennung: Sie übergeben nur die ID des Quellsongs, kein Trennmodus muss gewählt werden, und der Server verarbeitet immer als zwei Spuren (two).

Endpunkt: POST /api/music/vocal-removal

Abrechnung: Kostenlos. Dieser Endpunkt trennt nur Spuren; es entstehen keine Generierungskosten und es wird kein Abrechnungssatz geschrieben.

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

Authentifizierung

Anfrageparameter

Kompatible Aliase: sourceClipId, audio_id, audioId und song_id können statt source_clip_id verwendet werden.

Beispielanfrage

curl -X POST https://www.suno-api.io/api/music/vocal-removal \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "song_title": "Stimmenentfernung"
  }'

Antwort

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "vocals_clip_id",
        "song_title": "Stimmenentfernung (Vocals)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      },
      {
        "song_id": "instrumental_clip_id",
        "song_title": "Stimmenentfernung (Instrumental)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      }
    ]
  }
}

Eine einzelne Übermittlung liefert 2 Versionen × {Vocals, Instrumental}, daher enthält clips in der Regel 4 Einträge. Gruppieren Sie nach stem_from_id und unterscheiden Sie Gesang und Begleitung am Suffix von song_title.

Hinweise

• Fragen Sie die Ergebnis-Spuren mit der API zum Abfragen von Songs (POST /api/music/query) ab, bis der Status completed ist, bevor Sie sie verwenden; GET /api/music/songs/:song_id und die Verlaufsliste enthalten derzeit nicht die von der Stimmenentfernung erzeugten Spuren — das ist ein bekannter Unterschied.
• Wenn Sie den Zwei-Spur- oder Mehrspurmodus wählen oder nach Spurname trennen möchten, verwenden Sie die Stem-Trennung (Gesang/Begleitung)-API.
• Nicht benötigte Spuren lassen sich mit der Spur-Löschen-API ausblenden; senden Sie keine wiederholten Löschanfragen.