Extend API (विस्तार)

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

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

Extend किसी मौजूदा गाने को चुने गए समय-बिंदु से आगे बढ़ाता है और अगला हिस्सा बनाता है।

एंडपॉइंट: POST /api/music/extend

बिलिंग: सशुल्क, अभी डिफ़ॉल्ट 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 का अवलोकन में "प्रतीक्षा समय और टाइमआउट सेटिंग" देखें।

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

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`
audioId	string	हाँ	-	जिस गाने को बढ़ाना है उसका ID
prompt	string	हाँ	-	विस्तार का विवरण
continueAt	number	हाँ	-	विस्तार का शुरुआती बिंदु, सेकंड में। 0 से बड़ा और स्रोत गाने की अवधि से छोटा होना चाहिए; शुरुआती बिंदु के बाद कम से कम 10 सेकंड छोड़ें, वरना नतीजा उन्हीं कुछ सेकंड का होगा
style	string	नहीं	-	स्टाइल टैग
negativeTags	string	नहीं	-	बाहर रखे स्टाइल
title	string	नहीं	-	शीर्षक
sourceAudioUrl	string	नहीं	-	स्रोत ऑडियो URL
sourceFileName	string	नहीं	-	स्रोत फ़ाइल नाम
waitAudio	boolean	नहीं	false	ऑडियो पूरा होने का इंतज़ार करना है या नहीं

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

curl -X POST https://www.suno-api.io/api/music/extend \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "prompt": "कोरस को और तीव्र भाव के साथ आगे बढ़ाएँ",
    "continueAt": 60,
    "style": "Mandopop, rock",
    "negativeTags": "noise",
    "title": "विस्तारित संस्करण",
    "waitAudio": false
  }'

प्रतिक्रिया

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "extended_clip_id",
        "song_title": "विस्तारित संस्करण",
        "status": "pending"
      }
    ]
  }
}

संगत फ़ील्ड

पुराने फ़ील्ड नाम अब भी स्वीकार किए जाते हैं:

नया फ़ील्ड	संगत पुराना फ़ील्ड
audioId	song_id, audio_id
prompt	description
continueAt	start_time, continue_at
style	style_tags, tags
negativeTags	negative_tags
waitAudio	wait_audio

नोट

शुरुआती बिंदु को अंत से सटाकर न रखें: विस्तार की लंबाई मूलतः "शुरुआती बिंदु के बाद जो बचा है" के बराबर होती है। शुरुआती बिंदु अंत के बहुत पास हो तो नतीजा कुछ सेकंड का ही होगा — मापन में 242 सेकंड का गाना 240वें सेकंड से बढ़ाने पर केवल 2.7 सेकंड बना (और प्रति कॉल शुल्क फिर भी लगता है)। शुरुआती बिंदु के बाद कम से कम 10 सेकंड छोड़ें।
Extend में "स्रोत बहुत छोटा" की कोई सीमा नहीं है: मापन में 9.6 सेकंड की छोटी सामग्री को 5वें सेकंड से बढ़ाने पर भी सामान्य गाना बना, इसलिए छोटा स्रोत या छोटा शेष अस्वीकृति का कारण नहीं है।
शुरुआती बिंदु 0 से बड़ा होना चाहिए: continueAt=0 को प्लेटफ़ॉर्म स्वीकार करके फिर रद्द कर देता है, और विफलता का कारण भी नहीं देता; इसलिए पहले सेकंड के ठीक बाद से शुरू करें।
एक कॉल 2 नतीजे लौटाती है (2 गानों के रूप में बिल होती है); clips सरणी की लंबाई को आधार मानें।
नतीजा एक नई कृति है; मूल गाना प्रभावित नहीं होता।

अगलापूरा गाना जोड़ने वाला API (Get Full Song)

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

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

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