इंस्ट्रुमेंटल जोड़ने वाला API

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

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

इंस्ट्रुमेंटल जोड़ना किसी मौजूदा गाने को नया अरेंज करता है, उसमें वाद्य यंत्र जोड़ता है या नई संगत संरचना बनाता है।

एंडपॉइंट: POST /api/music/add-instrumental

बिलिंग: सशुल्क, अनुरोध किए गए मॉडल के अनुसार; असल में कटने वाली रकम बैक-ऑफ़िस मूल्य कॉन्फ़िगरेशन के अनुसार होती है।

Max Mode / Variety: यह एंडपॉइंट वैकल्पिक पैरामीटर max_mode और variety (0-4) का समर्थन करता है। max_mode चालू होने पर यह कॉल दोगुनी कीमत पर बिल होती है; variety से कोई अतिरिक्त शुल्क नहीं लगता। इनका अर्थ और भेजने का तरीका नए API का अवलोकन के "उन्नत पैरामीटर" खंड में है।

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

प्रतीक्षा समय और टाइमआउट (ज़रूरी): यह सिंक्रोनस एंडपॉइंट है — ऑर्डर तभी स्वीकार होता है और जनरेशन को सौंपा जाता है जब जवाब आ जाता है। मापन के अनुसार ज़्यादातर अनुरोध 1-3 सेकंड में जवाब देते हैं, लगभग 10% 30 सेकंड से ज़्यादा लेते हैं और सबसे लंबा लगभग 230 सेकंड का होता है। क्लाइंट टाइमआउट 300 सेकंड या ज़्यादा रखें; जवाब न आना इसका मतलब नहीं कि कुछ बना नहीं, और टाइमआउट के तुरंत बाद दोबारा कोशिश न करें (इससे ऑर्डर दोहरा होता है और दोबारा शुल्क लगता है)। अगर कनेक्शन टूट गया हो, तो बाद में GET /api/music/songs से जाँचें। नए API का अवलोकन में "प्रतीक्षा समय और टाइमआउट सेटिंग" देखें।

प्रमाणीकरण

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

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

curl -X POST https://www.suno-api.io/api/music/add-instrumental \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "lyrics": "",
    "style_tags": "cinematic, strings, acoustic guitar",
    "song_title": "बेहतर संगत वाला संस्करण",
    "audio_weight": 1,
    "wait_completion": false
  }'

प्रतिक्रिया

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "बेहतर संगत वाला संस्करण",
        "status": "pending"
      },
      {
        "song_id": "result_song_id_2",
        "song_title": "बेहतर संगत वाला संस्करण",
        "status": "pending"
      }
    ]
  }
}

एक कॉल 2 नतीजे लौटाती है (2 गानों के रूप में बिल होती है); उदाहरण में 2 दिखाए गए हैं। clips सरणी की लंबाई को आधार मानें और तय संख्या वाला लूप न लिखें। clips[].song_id सहेजें और completed तक पहुँचने के लिए गाना क्वेरी और इतिहास API से पोल करें। इसके बाद audio_url से चला या डाउनलोड कर सकते हैं; WAV बनाने और पाने वाला API तथा बाकी डाउनलोड एंडपॉइंट देखें।

नोट

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