API xoá stem

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

Mô tả endpoint

Xoá stem ẩn các track stem đã tạo khỏi danh sách. Việc xoá là xoá mềm: backend chỉ đánh dấu các dòng stem bằng stem_hidden; âm thanh, MIDI và tài nguyên tải xuống bên dưới vẫn được giữ, và cùng bài hát đó vẫn có thể tách lại thành stem mới sau này.

Endpoint: POST /api/music/stem-delete

Tính phí: Miễn phí. Việc xoá chỉ cập nhật trạng thái hiển thị trong nền tảng; không gọi Suno và không phát sinh phí.

Mô hình khuyến nghị: 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

Phải gửi ít nhất một trong song_id / song_ids / stem_batch_id / stem_mode, nếu không sẽ trả về 400.

Ví dụ yêu cầu

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

Phản hồi

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

Lưu ý

• Idempotent: nếu track đã bị ẩn hoặc ID không tồn tại thì trả về hidden: 0 và không báo lỗi, nên gọi lại vẫn an toàn.
• Việc xoá chỉ ảnh hưởng tới bài hát thuộc khóa API hiện tại; track không thuộc về bạn sẽ không bị thay đổi.
• Khi track stem cuối cùng còn hiển thị bị ẩn, dấu "đã tách" của bài hát nguồn cũng được xoá theo.