Replace Section API (अनुभाग बदलें)

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

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

Replace Section किसी मौजूदा गाने के एक समय-अंतराल को उसी जगह फिर से बनाता है। यह बोल की एक पंक्ति सुधारने या कोई हिस्सा बदलने के लिए उपयुक्त है।

एंडपॉइंट: POST /api/music/replace-section

बिलिंग: सशुल्क, अभी डिफ़ॉल्ट 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

Body पैरामीटर

startSeconds और endSeconds सेकंड में हैं और दशमलव स्वीकार करते हैं; startSeconds endSeconds से छोटा होना चाहिए और अंतराल मूल गाने की अवधि के भीतर होना चाहिए। requestedAt केवल तब इस्तेमाल होता है जब अनुरोध का समय भेजना ज़रूरी हो, Unix टाइमस्टैम्प सेकंड में (मिलीसेकंड में नहीं); आम तौर पर इसे छोड़ा जा सकता है।

बदलाव भी असिंक्रोनस कार्य है। लौटाया गया clip शुरू में pending हो सकता है, और उस समय ऑडियो पता खाली होना सामान्य है; अंतिम नतीजा पूछने के लिए लौटाए गए असली song_id का उपयोग करें।

अनुभाग की लंबाई: कम से कम 2 सेकंड (ज़रूरी)

बदले जाने वाला अंतराल 2 सेकंड से छोटा नहीं हो सकता। मापन: 1.0 / 1.2 / 1.5 सेकंड के अंतराल सभी विफल रहे, जबकि 2.0 सेकंड और उससे अधिक ठीक चले।

अंतराल बहुत छोटा होने पर प्लेटफ़ॉर्म "पैरामीटर त्रुटि" नहीं देता, बल्कि आसानी से गलत समझा जाने वाला संदेश देता है:

{"error":{"message":"You don't have access to this model. Upgrade your plan to use it.",
          "type":"bad_response_status_code","code":"bad_response_status_code"}}

यह वाक्य खाते या प्लान की समस्या नहीं है — अनुभाग बहुत छोटा है। अंतराल को 2 सेकंड से ऊपर बढ़ाकर फिर भेजें।

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

curl -X POST https://www.suno-api.io/api/music/replace-section \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "startSeconds": 30,
    "endSeconds": 45,
    "contextLyrics": "पूरा संदर्भ बोल",
    "contextWindowLyrics": "विंडो संदर्भ बोल",
    "infillLyrics": "बदलाव के बाद के बोल",
    "style": "Mandopop, acoustic",
    "title": "बदला हुआ संस्करण",
    "negativeTags": "noise"
  }'

प्रतिक्रिया

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "replace_clip_id",
        "song_title": "बदला हुआ संस्करण",
        "status": "pending"
      }
    ],
    "replaceTask": "infill",
    "clipId": "clip_id",
    "source_update": {}
  }
}

संगत फ़ील्ड

• audioId / audio_id / clipId / clip_id
• startSeconds / start_seconds / infillStartS / infill_start_s
• endSeconds / end_seconds / infillEndS / infill_end_s
• infillLyrics / infill_lyrics / replacementLyrics / replacement_lyrics
• style / tags
• negativeTags / negative_tags