गीत लेखन API
एंडपॉइंट विवरण
गीत लेखन किसी विषय, मौजूदा गीत पाठ के संदर्भ और शैली की ज़रूरतों के आधार पर गीत बनाता या दोबारा लिखता है। यह एंडपॉइंट नवीनतम गीत-लेखन अनुबंध पर अपग्रेड हो चुका है और प्रोफ़ेशनल मोड में जनरेशन के लिए सीधे इस्तेमाल किया जा सकता है।
एंडपॉइंट: POST /api/lyrics/generate
बिलिंग: कोटा के भीतर निःशुल्क (प्रति उपयोगकर्ता प्रति मिनट अधिकतम 10 कॉल और प्रति दिन 300); मुफ़्त कोटा से अधिक पर प्रति कॉल 0.1 CNY।
सीमा पार होने की पहचान: मुफ़्त कोटा पार होने पर भी अनुरोध सामान्य रूप से चलता है और प्रतिक्रिया हेडर में X-Suno-Helper-Free: false तथा X-Suno-Helper-Over-Limit: minute (या day) आते हैं, जिससे क्लाइंट बता सकता है कि यह कॉल शुल्क-योग्य थी।
सुझाया गया मॉडल: suno-v6। suno-v6, suno-v6-wild और suno-v6-mini उपलब्ध हैं।
प्रमाणीकरण
| पैरामीटर | प्रकार | ज़रूरी | नोट |
|---|---|---|---|
| Authorization | string | हाँ | Bearer YOUR_API_KEY |
| Content-Type | string | हाँ | application/json |
अनुरोध पैरामीटर
| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | नोट |
|---|---|---|---|---|
| model | string | हाँ | - | ग्राहक के लिए मॉडल नाम: suno-v6, suno-v6-wild या suno-v6-mini |
| instruction | string | हाँ | - | गीत का विषय या लेखन की ज़रूरत |
| style | string | नहीं | - | शैली की ज़रूरत |
| title | string | नहीं | - | गाने का शीर्षक या शीर्षक की बाध्यता |
| selected | string | नहीं | "" |
दोबारा लिखने के लिए चुना गया टेक्स्ट |
| context_before | string | नहीं | "" |
पूर्व संदर्भ |
| context_after | string | नहीं | "" |
परवर्ती संदर्भ |
| mode | string | नहीं | apply_user_request |
गीत लेखन मोड |
| references | array | नहीं | [] |
संदर्भ सामग्री की सूची |
| num_variants | integer | नहीं | null |
चाही गई गीत-वariant संख्या |
| lyricist_id | string | नहीं | null |
किसी विशेष गीतकार का ID (गीतकार सूची बंद हो चुकी है; नई इंटीग्रेशन की सलाह नहीं दी जाती) |
| metadata | object | नहीं | - | विस्तारित पैरामीटर; lyrics_model और enable_thinking समर्थित |
| lyrics_project_id | string | नहीं | null |
मौजूदा गीत प्रोजेक्ट का ID (गीत प्रोजेक्ट शृंखला बंद हो चुकी है; नई इंटीग्रेशन की सलाह नहीं दी जाती) |
instruction पुराने फ़ील्ड theme और prompt भी स्वीकार करता है। metadata.lyrics_model का डिफ़ॉल्ट default है और metadata.enable_thinking का डिफ़ॉल्ट false है।
भाषा नियंत्रण
इस एंडपॉइंट में अलग language अनुरोध फ़ील्ड नहीं है। गीत की भाषा instruction की सामग्री तय करती है; style केवल सहायक भूमिका निभा सकता है।
चीनी गीत पाने के लिए instruction में लक्ष्य भाषा स्पष्ट लिखें, जैसे:
{
"model": "suno-v6",
"instruction": "请用中文写歌词，主题是夏夜海边重逢",
"style": "Mandopop, 中文流行"
}
आप "Write the lyrics in Chinese about ..." भी लिख सकते हैं। अंग्रेज़ी गीत के लिए "请用英文写歌词" या "Write the lyrics in English" लिखें। केवल अंग्रेज़ी विषय भेजने और लक्ष्य भाषा न बताने पर नतीजा अंग्रेज़ी हो सकता है।
अनुरोध उदाहरण
curl -X POST https://www.suno-api.io/api/lyrics/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"instruction": "स्कूल पूरा होने और नई शुरुआत पर हिंदी गीत",
"style": "पॉप रॉक, सच्चा, यादगार कोरस",
"title": "नई शुरुआत",
"metadata": {
"lyrics_model": "default",
"enable_thinking": false
}
}'
प्रतिक्रिया
{
"code": 200,
"message": "success",
"data": {
"lyrics": "[Verse]\nहवा स्कूल के मैदान से गुज़रती है\nहम कल को अलविदा कहते हैं",
"edited_lyrics": "[Verse]\nहवा स्कूल के मैदान से गुज़रती है\nहम कल को अलविदा कहते हैं",
"lyrics_id": "lyrics_id",
"lyrics_request_id": "lyrics_request_id"
}
}
edited_lyrics वह पूरा गीत है जिसे गीत बॉक्स में डालना चाहिए। lyrics_id और lyrics_request_id ट्रैकिंग के लिए हैं और एंडपॉइंट की प्रतिक्रिया के अनुसार खाली हो सकते हैं; इन्हें गाना ID न मानें।
संगतता नोट
- पुराने फ़ील्ड
themeऔरpromptअब भी काम करते हैं औरinstructionमें मैप होते हैं। - "गीत प्रोजेक्ट / गीतकार" एंडपॉइंट शृंखला बंद हो चुकी है: अगर बने नतीजे सहेजने हों तो एंडपॉइंट से मिला
edited_lyricsखुद सहेजें।
API कुंजी प्राप्त करें
रजिस्टर करने के बाद कंसोल में API कुंजी बनाएँ। प्रत्येक जनरेशन का खर्च 0.6 युआन है और 2 ट्रैक मिलते हैं, डाउनलोड असीमित हैं और फ़ोन नंबर की ज़रूरत नहीं है।
API कुंजी लें अवलोकन पर लौटें