स्रोत क्लिप से कवर API

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

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

स्रोत क्लिप से कवर उस स्रोत क्लिप का दोबारा उपयोग करता है जिसे आप पहले ही अपलोड कर चुके हैं, या जो पहले से मौजूद है, और उसी के आधार पर नया कवर संस्करण बनाता है।

एंडपॉइंट: POST /api/music/generate-from-source

बिलिंग: सशुल्क, अभी डिफ़ॉल्ट 0.6 युआन प्रति कॉल। स्रोत ऑडियो अपलोड करना अपने आप में निःशुल्क है; शुल्क तब लगता है जब आप स्रोत क्लिप से कवर बनाते हैं। असल में कटने वाली रकम मौजूदा बैक-ऑफ़िस मूल्य कॉन्फ़िगरेशन के अनुसार होती है।

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

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

सुझाया गया उपयोग: यह «दो-चरणीय कवर» का चरण 2 है। चरण 1 में स्रोत ऑडियो अपलोड API से अपलोड करें (निःशुल्क) और clip_id सँभाल कर रखें; चरण 2 में कवर शुरू करने के लिए यह एंडपॉइंट कॉल करें। इस तरह ऑडियो सिर्फ़ निःशुल्क चरण में आता है: अपलोड बिगड़े तो बस दोबारा कोशिश करें और कोई शुल्क नहीं लगता, जबकि शुल्क वाले चरण का अनुरोध बॉडी केवल कुछ सौ बाइट्स का होता है, इसलिए ट्रांसफ़र टूटने से उसके विफल होने की गुंजाइश बहुत कम है। वहीं एक ही चरण में अपलोड और कवर API पूरा ऑडियो अनुरोध बॉडी में डालता है, इसलिए ऑडियो लगभग 8 MB से बड़ा होते ही वह रास्ते में कट जाता है और unexpected end of JSON input लौटाता है (उस पेज का "बड़ी फ़ाइलें और कटे अनुरोध" देखें)।

इसके अलावा वही clip_id Extend, Replace Section, स्टेम अलग करने और अन्य आगे के कामों में दोबारा इस्तेमाल किया जा सकता है, ऑडियो फिर से अपलोड करने की ज़रूरत नहीं।

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

Headers

पैरामीटर	प्रकार	ज़रूरी	नोट
Authorization	string	हाँ	Bearer YOUR_API_KEY
Content-Type	string	हाँ	application/json

Body पैरामीटर

पैरामीटर	प्रकार	ज़रूरी	डिफ़ॉल्ट	नोट
model	string	नहीं	suno-v6	ग्राहक के लिए मॉडल नाम: `suno-v6`, `suno-v6-wild` या `suno-v6-mini`
sourceClipId	string	हाँ	-	स्रोत क्लिप ID; आप स्रोत ऑडियो अपलोड से मिली `clip_id`, अपने पास पहले से मौजूद गाने की असली `song_id`, या प्रबलित अपलोड पूरा होने पर मिली असली `song_id` दे सकते हैं
sourceAudioUrl	string	नहीं	-	स्रोत ऑडियो का URL
sourceTitle	string	नहीं	-	स्रोत ऑडियो का शीर्षक
prompt	string	नहीं	-	नए बोल या रचनात्मक दिशा
customMode	boolean	नहीं	true	कस्टम मोड इस्तेमाल करना है या नहीं
style	string	नहीं	-	स्टाइल टैग
title	string	नहीं	-	शीर्षक
negativeTags	string	नहीं	-	नकारात्मक स्टाइल
instrumental	boolean	नहीं	false	गाना वाद्य-संगीत है या नहीं
waitAudio	boolean	नहीं	false	ऑडियो पूरा होने की प्रतीक्षा करनी है या नहीं
vocalGender	string	नहीं	-	आवाज़ का लिंग
lyricsMode	string	नहीं	-	बोल मोड
weirdnessConstraint	number	नहीं	-	यादृच्छिकता
styleWeight	number	नहीं	-	स्टाइल प्रभाव का भार
audio_weight	number	नहीं	-	संदर्भ ऑडियो पर निर्भरता, रेंज `0.0-1.0`; केवल तब भेजा जा सकता है जब स्रोत क्लिप या संदर्भ ऑडियो दिया गया हो

weirdnessConstraint, styleWeight और audio_weight तीनों 0.0 से 1.0 तक अनुपात के दशमलव लेते हैं, प्रतिशत का पूर्णांक नहीं; उदाहरण के लिए 50% को 0.5 लिखें। 0 मान्य मान है; सिर्फ़ फ़ील्ड छोड़ने का मतलब "निर्दिष्ट नहीं" है। audio_weight Suno के metadata.control_sliders.audio_weight पर मैप होता है और तय करता है कि नतीजा संदर्भ ऑडियो पर कितना टिकता है; इसे केवल तब भेजा जा सकता है जब अनुरोध में मान्य sourceClipId या संदर्भ ऑडियो हो, इसलिए सामान्य केवल-टेक्स्ट जनरेशन में इसे न भेजें। customMode=true होने पर नए बोल prompt में लिखें और style तथा title दोनों साथ दें; customMode=false होने पर रचनात्मक विवरण prompt में लिखें। instrumental और waitAudio में JSON बूलियन true/false ही इस्तेमाल करें।

यह एंडपॉइंट डिफ़ॉल्ट रूप से असिंक्रोनस जवाब देता है। जब तक लौटाया गया status pending है, audio_url का खाली होना सामान्य है; ऑडियो पता इस्तेमाल करने से पहले पूरा होने का इंतज़ार करें। sourceClipId असली स्रोत गाने/क्लिप की ID होनी चाहिए — task_id, client_request_id या pending: वाली प्लेसहोल्डर ID इस्तेमाल न करें।

`sourceClipId` कौन-सी ID है

sourceClipId असली Suno क्लिप पहचानकर्ता है जो इस कवर के स्रोत के रूप में इस्तेमाल होता है। प्लेटफ़ॉर्म का ग्राहक-मुखी गाना ऑब्जेक्ट इस पहचानकर्ता को आम तौर पर song_id कहता है, जबकि कवर अनुरोध पैरामीटर sourceClipId नाम ही रखते हैं; यहाँ दोनों एक ही असली गाना ID दर्शाते हैं।

अगर स्रोत प्रबलित अपलोड है, तो पहले प्रबलित अपलोड कार्य को क्वेरी करें और status के completed होने तक इंतज़ार करें, फिर लौटाई गई असली song_id को sourceClipId में डालें। यह भी सुझाया जाता है कि उस परिणाम की audio_url और title क्रमशः sourceAudioUrl और sourceTitle में डालें।

प्रबलित अपलोड की task_id, client_request_id या pending:enhanced-upload:* प्लेसहोल्डर ID को sourceClipId में न डालें।

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

curl -X POST https://www.suno-api.io/api/music/generate-from-source \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "sourceClipId": "uploaded_or_existing_clip_id",
    "sourceAudioUrl": "https://example.com/source.mp3",
    "sourceTitle": "मूल ऑडियो का शीर्षक",
    "prompt": "नए बोल या रचनात्मक दिशा",
    "customMode": true,
    "style": "Mandopop, warm vocal",
    "title": "कवर का शीर्षक",
    "negativeTags": "noise",
    "audio_weight": 0.5,
    "instrumental": false,
    "waitAudio": false
  }'

प्रतिक्रिया

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "new_clip_id",
        "song_title": "कवर का शीर्षक",
        "status": "pending"
      }
    ],
    "source_update": {}
  }
}

नोट

यह एंडपॉइंट स्रोत क्लिप के मालिक खाते का मसला जहाँ तक संभव हो संभालता है। अगर स्रोत क्लिप सीधे इस्तेमाल नहीं हो सकती, तो सर्वर स्रोत ऑडियो की जानकारी के आधार पर उसे दोबारा अपलोड कर सकता है और फिर जनरेट कर सकता है।

अगलाExtend API (विस्तार)

API कुंजी प्राप्त करें

रजिस्टर करने के बाद कंसोल में API कुंजी बनाएँ। प्रत्येक जनरेशन का खर्च 0.6 युआन है और 2 ट्रैक मिलते हैं, डाउनलोड असीमित हैं और फ़ोन नंबर की ज़रूरत नहीं है।

API कुंजी लें अवलोकन पर लौटें