वोकल रिमूवल API

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

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

वोकल रिमूवल किसी मौजूदा गाने को दो ट्रैक में बाँटता है: वोकल और संगत। यह ट्रैक अलग करने का शॉर्टकट रूप है: आपको केवल स्रोत गाने का ID भेजना होता है, अलग करने का मोड चुनने की ज़रूरत नहीं, और सर्वर हमेशा दो ट्रैक (two) के रूप में प्रोसेस करता है।

एंडपॉइंट: POST /api/music/vocal-removal

बिलिंग: निःशुल्क। यह एंडपॉइंट केवल ट्रैक अलग करता है; इससे जनरेशन लागत नहीं लगती और कोई शुल्क रिकॉर्ड भी नहीं बनता।

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

प्रमाणीकरण

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

संगत उपनाम: sourceClipId, audio_id, audioId और song_id — ये सभी source_clip_id की जगह इस्तेमाल हो सकते हैं।

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

curl -X POST https://www.suno-api.io/api/music/vocal-removal \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "song_title": "वोकल रिमूवल"
  }'

प्रतिक्रिया

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "vocals_clip_id",
        "song_title": "वोकल रिमूवल (Vocals)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      },
      {
        "song_id": "instrumental_clip_id",
        "song_title": "वोकल रिमूवल (Instrumental)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      }
    ]
  }
}

एक सबमिशन 2 वर्ज़न × {Vocals, Instrumental} लौटाता है, इसलिए clips में आम तौर पर 4 एंट्री होती हैं। stem_from_id से समूह बनाएँ और song_title के प्रत्यय से वोकल और संगत अलग पहचानें।

नोट

• नतीजे वाले ट्रैक इस्तेमाल करने से पहले गाना क्वेरी और इतिहास API (POST /api/music/query) से completed तक पोल करें; GET /api/music/songs/:song_id और इतिहास सूची फ़िलहाल वोकल रिमूवल से बने ट्रैक शामिल नहीं करतीं — यह ज्ञात अंतर है।
• अगर दो ट्रैक या मल्टी-ट्रैक मोड चुनना है, या ट्रैक नाम से अलग करना है, तो ट्रैक अलग करने वाला (वोकल और संगत) API इस्तेमाल करें।
• अनचाहे ट्रैक ट्रैक डिलीट API से छिपाए जा सकते हैं; डिलीट अनुरोध बार-बार न भेजें।