स्टेम हटाने वाला API

2026-09-18 को अद्यतन · Suno-API टीम

एंडपॉइंट विवरण

स्टेम हटाना पहले से बनी स्टेम ट्रैक को सूची से छिपा देता है। हटाना सॉफ़्ट डिलीट है: बैकएंड केवल स्टेम पंक्तियों पर stem_hidden का निशान लगाता है; नीचे का ऑडियो, MIDI और डाउनलोड संसाधन बने रहते हैं, और उसी गाने को बाद में फिर से नए स्टेम में अलग किया जा सकता है।

एंडपॉइंट: POST /api/music/stem-delete

बिलिंग: मुफ़्त। हटाना केवल प्लेटफ़ॉर्म के भीतर दृश्यता बदलता है; Suno को कॉल नहीं करता और कोई शुल्क नहीं बनता।

सुझाया गया मॉडल: suno-v6। suno-v6, suno-v6-wild और suno-v6-mini उपलब्ध हैं।

प्रमाणीकरण

अनुरोध पैरामीटर

song_id / song_ids / stem_batch_id / stem_mode में से कम से कम एक भेजना ज़रूरी है, वरना 400 मिलता है।

अनुरोध उदाहरण

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

प्रतिक्रिया

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

नोट

• इडेम्पोटेंट: अगर ट्रैक पहले से छिपा है या ID मौजूद नहीं है, तो hidden: 0 मिलता है और कोई त्रुटि नहीं, इसलिए दोबारा कॉल करना सुरक्षित है।
• हटाना केवल मौजूदा API कुंजी के गानों पर असर डालता है; जो ट्रैक आपके नहीं हैं वे नहीं बदलते।
• सूची में आख़िरी दिखने वाला स्टेम छिपते ही स्रोत गाने का "अलग किया गया" चिह्न भी हट जाता है।