API penyingkiran vokal

Dikemas kini 2026-09-18 · pasukan Suno-API

Penerangan endpoint

Penyingkiran vokal memecahkan lagu sedia ada kepada dua trek: vokal dan iringan. Ini bentuk ringkas bagi pemisahan trek: cukup hantar ID lagu sumber, tidak perlu memilih mod pemisahan, dan pelayan sentiasa memproses sebagai dua trek (two).

Endpoint: POST /api/music/vocal-removal

Pengebilan: Percuma. Endpoint ini hanya memecahkan trek; tiada kos penjanaan dan tiada rekod caj ditulis.

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

Pengesahan

Parameter permintaan

Alias serasi: sourceClipId, audio_id, audioId dan song_id semuanya boleh menggantikan 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": "Penyingkiran vokal"
  }'

Respons

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

Satu penghantaran memulangkan 2 versi × {Vocals, Instrumental}, jadi clips biasanya mengandungi 4 entri. Kumpulkan mengikut stem_from_id dan bezakan vokal daripada iringan melalui akhiran song_title.

Nota

• Tinjau trek hasil dengan API pertanyaan lagu dan sejarah (POST /api/music/query) sehingga completed sebelum digunakan; GET /api/music/songs/:song_id dan senarai sejarah buat masa ini tidak merangkumi trek yang dihasilkan oleh penyingkiran vokal — ini perbezaan yang diketahui.
• Jika perlu memilih mod dua atau banyak trek, atau memisahkan mengikut nama trek, gunakan API pemisahan trek (vokal dan iringan).
• Trek yang tidak diperlukan boleh disembunyikan dengan API penyingkiran trek; jangan hantar permintaan hapus berulang.