API de eliminare a vocii

Actualizat pe 2026-09-18 · echipa Suno-API

Descrierea endpoint-ului

Eliminarea vocii împarte o piesă existentă în două piste: voce și acompaniament. Este forma rapidă a separării: trebuie să trimiți doar ID-ul piesei sursă, nu e nevoie să alegi modul de separare, iar serverul procesează întotdeauna ca două piste (two).

Endpoint: POST /api/music/vocal-removal

Facturare: Gratuit. Acest endpoint doar separă piste; nu generează costuri de generare și nu scrie nicio înregistrare de debitare.

Model recomandat: suno-v6. Sunt disponibile suno-v6, suno-v6-wild și suno-v6-mini.

Autentificare

Parametrii cererii

Aliasuri compatibile: sourceClipId, audio_id, audioId și song_id pot înlocui source_clip_id.

Exemplu de cerere

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": "Eliminarea vocii"
  }'

Răspuns

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

O singură trimitere returnează 2 versiuni × {Vocals, Instrumental}, așa că clips conține de obicei 4 intrări. Grupează după stem_from_id și distinge vocea de acompaniament după sufixul din song_title.

Note

• Interoghează piesele rezultate cu API de interogare a pieselor și de istoric (POST /api/music/query) până la completed înainte de a le folosi; GET /api/music/songs/:song_id și lista de istoric nu includ în prezent piesele create de eliminarea vocii — este o diferență cunoscută.
• Dacă vrei să alegi modul cu două sau mai multe piste, sau să separi după numele pistei, folosește API de separare (voce și acompaniament).
• Piesele nedorite pot fi ascunse cu API de ștergere pistă; nu trimite cereri de ștergere repetate.