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

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

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

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

चरण 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" \
  -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"
  }
}

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

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

आगे के चरण

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