त्वरित शुरुआत

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

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

मौजूदा डिफ़ॉल्ट मॉडल suno-v6 है। suno-v2 से suno-v5-5 तक के जनरेशन मॉडल बंद कर दिए गए हैं: वे पुराने कार्यों में दिख सकते हैं, लेकिन नए अनुरोध स्वीकार नहीं करते।

इस पते से suno-api agent kit डाउनलोड, इंस्टॉल और कॉन्फ़िगर करें  https://www.suno-api.io/suno-agent-kit.zip

अनुशंसित: AI से पूरा integration करवाएँ

AI 00_START_HERE.md पढ़कर पंजीकरण, API Key सहेजने, बैलेंस जाँचने, सभी सुविधाएँ समझाने और पहली generation में मदद करेगा। भुगतान वाले काम से पहले पुष्टि ली जाती है और timeout पर अपने आप दोबारा request नहीं भेजी जाती।

चरण 1: API कुंजी लें

1. https://www.suno-api.io खोलें।
2. API कुंजी लें पर क्लिक करके रजिस्टर करें। केवल ईमेल चाहिए, फ़ोन नंबर नहीं।
3. कंसोल में टोकन प्रबंधन खोलें और एक कुंजी बनाएँ।
4. तुरंत कॉपी करें — कुंजी केवल एक बार दिखती है। पहले सशुल्क कॉल से पहले रीडीम कोड से बैलेंस भरें।

चरण 2: अनुरोध तैयार करें

सभी कॉल एक ही बेस URL और एक ही हेडर इस्तेमाल करते हैं:

POST https://www.suno-api.io
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

चरण 3: पहला अनुरोध भेजें

उदाहरण 1 — विवरण से बनाना

संगीत का वर्णन करें, और API बोल, धुन और अरेंजमेंट लिख देगा:

curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 300 \
  -d '{
    "description": "वसंत के पहले दिन पर एक खुशमिजाज़ फ़ॉक गीत",
    "model": "suno-v6"
  }'

प्रतिक्रिया:

[
  {
    "song_id": "abc123",
    "status": "pending",
    "song_title": "वसंत की कहानी",
    "description": "वसंत के पहले दिन पर एक खुशमिजाज़ फ़ॉक गीत",
    "created_at": "2026-04-22T10:30:00Z"
  },
  {
    "song_id": "def456",
    "status": "pending",
    "song_title": "वसंत के कदम",
    "description": "वसंत के पहले दिन पर एक खुशमिजाज़ फ़ॉक गीत",
    "created_at": "2026-04-22T10:30:00Z"
  }
]

हर बार दो अलग संस्करण मिलते हैं, जिनमें से आप चुन सकते हैं। एक जनरेशन की कीमत 0,6 ¥ है।

उदाहरण 2 — प्रगति देखना

मिली song_id मानों को क्वेरी एंडपॉइंट पर भेजें:

curl -X POST https://www.suno-api.io/api/music/query \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_ids": ["abc123", "def456"],
    "model": "suno-v6"
  }'

जब कार्य चल रहा हो:

[
  {
    "song_id": "abc123",
    "status": "processing",
    "song_title": "वसंत की कहानी",
    "progress": "60%"
  }
]

और पूरा होने पर:

[
  {
    "song_id": "abc123",
    "status": "completed",
    "song_title": "वसंत की कहानी",
    "audio_url": "https://media.code-go.com/assets/abc123-mp3.mp3",
    "video_url": "https://media.code-go.com/assets/abc123-mp4.mp4",
    "cover_url": "https://media.code-go.com/assets/abc123-cover.jpg",
    "duration": 168
  }
]

status मान pending, submitted, processing से गुज़रकर completed पर पहुँचता है। कार्य चलते समय पते खाली रह सकते हैं: निर्णय status से करें, audio_url की मौजूदगी से नहीं।

चरण 4: फ़ाइल डाउनलोड करें

जब status मान completed हो जाए, तो सिर्फ़ audio_url माँगें। MP3 और WAV डाउनलोड असीमित हैं और कोई अतिरिक्त शुल्क नहीं लेते। अगर एडिटिंग के लिए लॉसलेस ऑडियो चाहिए, तो WAV एंडपॉइंट इस्तेमाल करें।

आम परिदृश्य

वीडियो के लिए बैकग्राउंड संगीत

{
  "description": "प्रोडक्ट वीडियो के लिए शांत lo-fi बैकग्राउंड, बिना वोकल, स्थिर डायनैमिक्स",
  "instrumental": true,
  "model": "suno-v6"
}

instrumental को true रखने पर आउटपुट में वोकल नहीं होगा।

अपने बोल और स्टाइल

{
  "lyrics": "[Verse 1]\nशहर की रोशनी धीरे-धीरे बुझती है\n\n[Chorus]\nहम चलते रहते हैं",
  "style": "acoustic pop, गर्म महिला स्वर, 92 BPM",
  "model": "suno-v6"
}

पूरा होने तक पूछते रहना

import time
import requests

API_KEY = "sk-your-key-here"
BASE = "https://www.suno-api.io"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

created = requests.post(
    f"{BASE}/api/music/create",
    headers=HEADERS,
    json={"description": "वसंत पर एक खुशमिजाज़ फ़ॉक गीत", "model": "suno-v6"},
).json()

song_ids = [track["song_id"] for track in created]

for _ in range(60):
    time.sleep(10)
    tracks = requests.post(
        f"{BASE}/api/music/query",
        headers=HEADERS,
        json={"song_ids": song_ids, "model": "suno-v6"},
    ).json()
    if all(track.get("status") == "completed" for track in tracks):
        for track in tracks:
            print(track["song_title"], track["audio_url"])
        break

त्रुटि प्रबंधन

मुख्य कोड

त्रुटि का प्रारूप

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

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

सर्वोत्तम अभ्यास

• कुंजी सर्वर पर रखें, ब्राउज़र या बाँटे गए ऐप में कभी न रखें।
• कसी हुई लूप की जगह हर 10–15 सेकंड में क्वेरी करें।
• song_id सहेजें: बाद में ऑडियो ढूँढने का यही एकमात्र पहचानकर्ता है।
• 429 और 500 पर दोबारा भेजें; 400 और 401 में पहले कारण ठीक करें।
• असफल जनरेशन अपने आप वापस हो जाते हैं, इसलिए असफल कार्य पर कुछ खर्च नहीं होता।
• क्लाइंट टाइमआउट: जनरेशन एंडपॉइंट जवाब आने पर ही स्वीकृत माना जाता है; टाइमआउट 300 सेकंड या ज़्यादा रखें।
• दोबारा कोशिश: सिर्फ़ साफ़ विफलता (4xx/5xx) पर दोबारा कोशिश करें। टाइमआउट या कनेक्शन टूटने के बाद पहले GET /api/music/songs से जाँचें कि ऑर्डर स्वीकार हो चुका है या नहीं, ताकि ऑर्डर दोहरा न हो और दोबारा शुल्क न लगे।

आगे के चरण

• प्रमाणीकरण — कुंजियाँ, त्रुटियाँ और सीमाएँ
• समर्थित मॉडल — मॉडल नाम, स्टेम अलगाव और बंद किए गए मॉडल