Stem silme API'si

2026-09-18 tarihinde güncellendi · Suno-API ekibi

Uç nokta açıklaması

Stem silme, daha önce üretilmiş stem parçalarını listeden gizler. Silme bir yumuşak silmedir: arka uç yalnızca stem satırlarını stem_hidden ile işaretler; alttaki ses, MIDI ve indirme kaynakları korunur ve aynı şarkı daha sonra yeni stemlere yeniden ayrılabilir.

Uç nokta: POST /api/music/stem-delete

Faturalama: Ücretsiz. Silme yalnızca platform içindeki görünürlüğü günceller; Suno'yu çağırmaz ve ücret oluşturmaz.

Önerilen model: suno-v6. suno-v6, suno-v6-wild ve suno-v6-mini kullanılabilir.

Kimlik doğrulama

Parametre	Tür	Zorunlu	Notlar
Authorization	string	evet	`Bearer YOUR_API_KEY`
Content-Type	string	evet	`application/json`

İstek parametreleri

Parametre	Tür	Zorunlu	Varsayılan	Notlar
song_id	string	hayır	-	Tek bir stem parçasının `song_id` değeri (`/api/music/separate` tarafından döndürülen parça ID'si)
song_ids	string[]	hayır	-	Toplu biçim, çağrı başına en fazla 100
stem_batch_id	string	hayır	-	Parti bazında silme: o otomatik ayırma partisinin tüm parçalarını kaldırır
stem_mode	string	hayır	-	Moda göre silme, örneğin `two`, `twelve`

song_id / song_ids / stem_batch_id / stem_mode değerlerinden en az biri verilmelidir; yoksa yanıt 400 olur.

İstek örneği

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

Yanıt

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

Alan	Tür	Notlar
hidden	number	Bu çağrıda gizlenen parça sayısı
affected_sources	number	Etkilenen kaynak şarkı sayısı

Notlar

Idempotent: parça zaten gizliyse veya ID yoksa yanıt hidden: 0 olur ve hata vermez, bu yüzden tekrar çağırmak güvenlidir.
Silme yalnızca geçerli API anahtarına ait şarkıları etkiler; size ait olmayan parçalar değiştirilmez.
Listedeki son görünür stem gizlendiğinde, kaynak şarkının "ayrıldı" işareti de onunla birlikte silinir.

SonrakiWAV oluşturma/alma API'si

API anahtarı alın

Kaydolduktan sonra konsoldan bir API anahtarı oluşturun. Her üretim 0,6 ¥ tutarındadır ve 2 parça döner, indirmeler sınırsızdır ve telefon numarası gerekmez.

API anahtarı al Genel bakışa dön