API penghapusan vokal

Diperbarui 2026-09-18 · tim Suno-API

Deskripsi endpoint

Penghapusan vokal memecah lagu yang sudah ada menjadi dua track: vokal dan instrumen. Ini bentuk ringkas dari pemisahan track: cukup kirim ID lagu sumber, tidak perlu memilih mode pemisahan, dan server selalu memproses sebagai dua track (two).

Endpoint: POST /api/music/vocal-removal

Biaya: Gratis. Endpoint ini hanya memecah track; tidak menimbulkan biaya pembuatan dan tidak menulis catatan penagihan.

Model yang disarankan: suno-v6. Tersedia suno-v6, suno-v6-wild, dan suno-v6-mini.

Autentikasi

Parameter permintaan

Alias yang kompatibel: sourceClipId, audio_id, audioId, dan song_id semuanya bisa dipakai sebagai pengganti source_clip_id.

Contoh permintaan

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": "Penghapusan vokal"
  }'

Respons

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

Satu pengiriman mengembalikan 2 versi × {Vocals, Instrumental}, jadi clips biasanya berisi 4 entri. Kelompokkan berdasarkan stem_from_id dan bedakan vokal dari instrumen lewat akhiran song_title.

Catatan

• Poling track hasil dengan API kueri lagu dan riwayat (POST /api/music/query) sampai completed sebelum dipakai; GET /api/music/songs/:song_id dan daftar riwayat saat ini tidak menyertakan track yang dihasilkan penghapusan vokal — ini perbedaan yang diketahui.
• Jika perlu memilih mode dua atau banyak track, atau memisahkan berdasarkan nama track, gunakan API pemisahan track (vokal dan instrumen).
• Track yang tidak diperlukan bisa disembunyikan dengan API penghapusan track; jangan mengirim permintaan hapus berulang.