API padam stem

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

Penerangan endpoint

Padam stem menyembunyikan trek stem yang telah dijana daripada senarai. Pemadaman ialah padam lembut: bahagian belakang hanya menandakan baris stem dengan stem_hidden; audio, MIDI dan sumber muat turun di bawahnya dikekalkan, dan lagu yang sama masih boleh dipisahkan semula kepada stem baharu kemudian.

Endpoint: POST /api/music/stem-delete

Pengebilan: Percuma. Pemadaman hanya mengemas kini kebolehlihatan dalam platform; tidak memanggil Suno dan tidak menimbulkan sebarang kos.

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

Pengesahan

Parameter	Jenis	Wajib	Nota
Authorization	string	ya	`Bearer YOUR_API_KEY`
Content-Type	string	ya	`application/json`

Parameter permintaan

Parameter	Jenis	Wajib	Lalai	Nota
song_id	string	tidak	-	`song_id` bagi satu trek stem (ID trek yang dikembalikan oleh `/api/music/separate`)
song_ids	string[]	tidak	-	Bentuk pukal, maksimum 100 setiap panggilan
stem_batch_id	string	tidak	-	Padam ikut kelompok: membuang semua trek bagi kelompok pemisahan automatik itu
stem_mode	string	tidak	-	Padam ikut mod, contohnya `two`, `twelve`

Sekurang-kurangnya satu daripada song_id / song_ids / stem_batch_id / stem_mode mesti dihantar, 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
  }
}

Medan	Jenis	Nota
hidden	number	Bilangan trek yang disembunyikan oleh panggilan ini
affected_sources	number	Bilangan lagu sumber yang terjejas

Nota

Idempoten: jika trek sudah disembunyikan atau ID tidak wujud, hasilnya hidden: 0 tanpa ralat, jadi memanggil semula adalah selamat.
Pemadaman hanya menjejaskan lagu milik kunci API semasa; trek yang bukan milik anda tidak diubah.
Apabila stem terakhir yang kelihatan disembunyikan, penanda "telah dipisahkan" pada lagu sumber turut dipadamkan.

SeterusnyaAPI penjanaan/pengambilan WAV

Dapatkan kunci API

Cipta kunci API dalam konsol selepas mendaftar. Setiap penjanaan berharga 0.6 ¥ dan mengembalikan 2 lagu, muat turun tanpa had dan nombor telefon tidak diperlukan.

Dapatkan kunci API Kembali ke gambaran