API de ștergere a stemurilor

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

Descrierea endpoint-ului

Ștergerea stemurilor ascunde din listă pistele de stem deja generate. Ștergerea este logică: backendul doar marchează rândurile de stem cu stem_hidden; audio-ul, MIDI-ul și resursele de descărcare se păstrează, iar aceeași piesă poate fi separată din nou în stemuri noi mai târziu.

Endpoint: POST /api/music/stem-delete

Facturare: Gratuit. Ștergerea actualizează doar vizibilitatea în platformă; nu apelează Suno și nu generează nicio taxă.

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

Autentificare

Parametru	Tip	Obligatoriu	Observații
Authorization	string	da	`Bearer YOUR_API_KEY`
Content-Type	string	da	`application/json`

Parametrii cererii

Parametru	Tip	Obligatoriu	Implicit	Observații
song_id	string	nu	-	`song_id`-ul unei singure piste de stem (ID-ul returnat de `/api/music/separate`)
song_ids	string[]	nu	-	Formă în lot, cel mult 100 per apel
stem_batch_id	string	nu	-	Ștergere pe lot: elimină toate pistele acelui lot de separare automată
stem_mode	string	nu	-	Ștergere pe mod, de exemplu `two`, `twelve`

Trebuie trimis cel puțin unul dintre song_id / song_ids / stem_batch_id / stem_mode, altfel răspunsul este 400.

Exemplu de cerere

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

Răspuns

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

Câmp	Tip	Observații
hidden	number	Câte piste au fost ascunse de acest apel
affected_sources	number	Câte piese sursă au fost afectate

Note

Idempotent: dacă pista este deja ascunsă sau ID-ul nu există, răspunsul este hidden: 0 fără eroare, deci repetarea apelului este sigură.
Ștergerea afectează doar piesele cheii API curente; pistele care nu sunt ale tale nu sunt modificate.
Când ultimul stem vizibil din listă este ascuns, marcajul „separată" al piesei sursă este și el șters.

UrmătorulAPI de generare/obținere a WAV

Obține o cheie API

Creează o cheie API în consolă după înregistrare. Fiecare generare costă 0,6 ¥ și returnează 2 piese, descărcările sunt nelimitate și nu este nevoie de număr de telefon.

Obține cheia API Înapoi la prezentare