API xóa giọng hát

Cập nhật 2026-09-18 · nhóm Suno-API

Mô tả endpoint

Xóa giọng hát tách một bài hát đã có thành hai track: giọng hát và nhạc đệm. Đây là dạng rút gọn của tách track: chỉ cần gửi ID bài hát nguồn, không cần chọn chế độ tách, và máy chủ luôn xử lý theo hai track (two).

Endpoint: POST /api/music/vocal-removal

Tính phí: Miễn phí. Endpoint này chỉ tách track, không phát sinh chi phí tạo nhạc và không ghi giao dịch trừ phí.

Mô hình đề xuất: suno-v6. Có thể dùng suno-v6, suno-v6-wild hoặc suno-v6-mini.

Xác thực

Tham số yêu cầu

Bí danh tương thích: sourceClipId, audio_id, audioId và song_id đều có thể thay cho source_clip_id.

Ví dụ yêu cầu

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": "Xóa giọng hát"
  }'

Phản hồi

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "vocals_clip_id",
        "song_title": "Xóa giọng hát (Vocals)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      },
      {
        "song_id": "instrumental_clip_id",
        "song_title": "Xóa giọng hát (Instrumental)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      }
    ]
  }
}

Một lần gửi trả về 2 phiên bản × {Vocals, Instrumental}, nên clips thường có 4 mục. Hãy nhóm theo stem_from_id và phân biệt giọng hát với nhạc đệm qua hậu tố của song_title.

Lưu ý

• Hãy dùng API truy vấn bài hát và lịch sử (POST /api/music/query) để hỏi cho đến khi completed trước khi dùng; GET /api/music/songs/:song_id và danh sách lịch sử hiện không bao gồm các track do xóa giọng hát tạo ra — đây là khác biệt đã biết.
• Nếu cần chọn chế độ hai track hoặc nhiều track, hoặc tách theo tên track, hãy dùng API tách track (giọng hát và nhạc đệm).
• Track không cần thiết có thể ẩn bằng API xóa track; đừng gửi yêu cầu xóa lặp lại.