API di rimozione della voce

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

Descrizione dell'endpoint

La rimozione della voce scompone un brano esistente in due tracce: voce e base. È la forma rapida della separazione: basta inviare l'ID del brano di origine, non serve scegliere la modalità di separazione e il server elabora sempre come due tracce (two).

Endpoint: POST /api/music/vocal-removal

Fatturazione: Gratuito. Questo endpoint esegue solo la separazione delle tracce; non comporta costi di generazione e non registra alcun addebito.

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

Autenticazione

Parametri della richiesta

Alias compatibili: sourceClipId, audio_id, audioId e song_id possono sostituire source_clip_id.

Esempio di richiesta

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": "Rimozione della voce"
  }'

Risposta

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

Un singolo invio restituisce 2 versioni × {Vocals, Instrumental}, quindi clips di solito contiene 4 voci. Raggruppa per stem_from_id e distingui voce e base dal suffisso di song_title.

Note

• Interroga le tracce risultanti con l'API di consultazione e cronologia dei brani (POST /api/music/query) fino a completed prima di usarle; GET /api/music/songs/:song_id e l'elenco della cronologia attualmente non includono le tracce prodotte dalla rimozione della voce — è una differenza nota.
• Se devi scegliere la modalità a due o più tracce, o separare per nome traccia, usa l'API di separazione (voce e base).
• Le tracce non necessarie possono essere nascoste con l'API di eliminazione traccia; non inviare richieste di eliminazione ripetute.