API di eliminazione delle tracce separate

Aggiornato il 2026-09-18 · team Suno-API

Descrizione dell'endpoint

L'eliminazione delle tracce separate nasconde dall'elenco le tracce già generate. L'eliminazione è logica: il backend si limita a marcare le righe con stem_hidden; l'audio, il MIDI e le risorse di download sottostanti vengono conservati, e lo stesso brano potrà essere separato di nuovo in nuove tracce in seguito.

Endpoint: POST /api/music/stem-delete

Fatturazione: Gratis. L'eliminazione aggiorna solo la visibilità all'interno della piattaforma; non chiama Suno e non genera alcun addebito.

Modello consigliato: suno-v6. Sono disponibili suno-v6, suno-v6-wild e suno-v6-mini.

Autenticazione

Parametri della richiesta

Va indicato almeno uno tra song_id / song_ids / stem_batch_id / stem_mode, altrimenti la risposta è 400.

Esempio di richiesta

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

Risposta

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

Note

• Idempotente: se la traccia è già nascosta o l'ID non esiste, la risposta è hidden: 0 senza errore, quindi ripetere la chiamata è sicuro.
• L'eliminazione riguarda solo i brani della chiave API attuale; le tracce che non sono tue non vengono toccate.
• Quando l'ultima traccia visibile dell'elenco viene nascosta, anche il contrassegno «separato» del brano di origine viene rimosso.