API hapus stem

Diperbarui 2026-09-18 · tim Suno-API

Deskripsi endpoint

Hapus stem menyembunyikan track stem yang sudah dibuat dari daftar. Penghapusan bersifat soft delete: backend hanya menandai baris stem dengan stem_hidden; audio, MIDI, dan sumber unduhan yang mendasarinya tetap disimpan, dan lagu yang sama masih bisa dipisah lagi menjadi stem baru nanti.

Endpoint: POST /api/music/stem-delete

Biaya: Gratis. Penghapusan hanya memperbarui visibilitas di dalam platform; tidak memanggil Suno dan tidak menimbulkan biaya.

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

Autentikasi

Parameter permintaan

Minimal satu dari song_id / song_ids / stem_batch_id / stem_mode harus dikirim, jika tidak hasilnya 400.

Contoh permintaan

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

Respons

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

Catatan

• Idempoten: bila track sudah disembunyikan atau ID tidak ada, hasilnya hidden: 0 tanpa error, jadi memanggil ulang aman.
• Penghapusan hanya memengaruhi lagu milik kunci API saat ini; track yang bukan milik Anda tidak diubah.
• Saat stem terakhir yang terlihat disembunyikan, penanda "sudah dipisah" pada lagu sumber ikut dihapus.