Free2 डाउनलोड API

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

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

Free2 एक अलग सशुल्क डाउनलोड चैनल है: यह गाने की ID (या suno.com गाने के लिंक) से MP3/WAV/गीत/मेटाडेटा फ़ाइलें निकालता है और प्लेटफ़ॉर्म पर होस्ट किए गए डाउनलोड पते लौटाता है। यह केवल API Key स्वीकार करता है, ब्राउज़र लॉगिन सेशन स्वीकार नहीं करता, और प्रतिक्रिया में Suno का एन्क्रिप्टेड प्लेबैक स्रोत कभी नहीं आता।

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

बिलिंग: सफल गानों की संख्या पर शुल्क लगता है, फ़िलहाल डिफ़ॉल्ट 0.2 CNY प्रति गाना। एक ही अनुरोध में कई फ़ाइल प्रकार चुनने पर अतिरिक्त शुल्क नहीं लगता; जो गाने निकाले नहीं जा सके उनका शुल्क नहीं लगता। एक अनुरोध में अधिकतम 10 गाने (डुप्लीकेट हटाने के बाद); वास्तव में कटी राशि बैक-ऑफ़िस की मूल्य सेटिंग के अनुसार होती है।

सुझाया गया मॉडल: suno-v6। suno-v6, suno-v6-wild और suno-v6-mini उपलब्ध हैं।

प्रमाणीकरण

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

song_id और song_ids में से कम से कम एक दें; files में कम से कम एक मान दें।

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

curl -X POST https://www.suno-api.io/api/music/free2 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_ids": ["song_id_1", "song_id_2"],
    "files": ["mp3", "wav", "lyrics"]
  }'

प्रतिक्रिया

{
  "code": 200,
  "message": "success",
  "data": {
    "songs": [
      {
        "song_id": "song_id_1",
        "files": [
          {"type": "mp3", "url": "https://media.suno-api.io/assets/song_id_1-free2-v1-mp3.mp3"}
        ]
      },
      {
        "song_id": "song_id_2",
        "files": [],
        "error": {"code": "song_not_found", "message": "song not found or not owned by the current user"}
      }
    ],
    "requested_songs": 2,
    "succeeded_songs": 1,
    "price": 0.2
  }
}

केवल एक गाना माँगने पर, पुराने एक-गाना रूप के साथ संगतता के लिए प्रतिक्रिया में शीर्ष स्तर पर song_id और files भी लौटते हैं।

कैश किए गए पते दोबारा उपयोग करें (कोई शुल्क नहीं)

जो गाना आप पहले डाउनलोड कर चुके हैं, उसे दोबारा डाउनलोड करने पर नया निष्कर्षण नहीं चाहिए और दोबारा शुल्क भी नहीं लगता: इस खाते ने पहले जो फ़ाइलें डाउनलोड की थीं, उनके मौजूदा पते POST /api/music/free2/cached से ले लें।

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

बिलिंग: निःशुल्क। यह केवल-पढ़ने वाला कैश है: न निष्कर्षण, न ट्रांसकोडिंग, न शुल्क; केवल वे पते लौटते हैं जो तैयार हैं और वापस नहीं लिए गए।

⚠️ डाउनलोड पते की वैधता: 7 दिन — समय रहते सहेजें। songs[].files[].url प्लेटफ़ॉर्म के ऑब्जेक्ट स्टोरेज से मिलता है और डिफ़ॉल्ट रूप से 7 दिन बाद समाप्त हो जाता है (फ़ाइलें वापस ले ली जाती हैं और पुराना पता 404 लौटाता है); इन 7 दिनों में उन्हें अपने स्टोरेज में सहेज लें। समाप्त होने के बाद नया वैध पता पाने के लिए POST /api/music/free2 दोबारा कॉल करें (उस पुनः तैयारी पर सामान्य नियमों से शुल्क लगता है; /api/music/free2/cached केवल अब भी वैध कैश पते ही लौटाता है)।

अनुरोध पैरामीटर: POST /api/music/free2 के बिल्कुल समान (song_id / song_ids / songs में से कोई एक, और files में कम से कम एक मान)।

curl -X POST https://www.suno-api.io/api/music/free2/cached \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "song_ids": ["98ca3f1d-…", "a185b3d9-…"], "files": ["mp3"] }'

{
  "success": true,
  "data": {
    "items": [
      { "song_id": "98ca3f1d-…", "type": "mp3", "url": "https://…/assets/98ca3f1d-…-free2-v1-mp3.mp3" }
    ],
    "songs": [
      { "song_id": "98ca3f1d-…", "files": [ { "type": "mp3", "url": "https://…" } ], "missing_files": [] },
      { "song_id": "a185b3d9-…", "files": [], "missing_files": ["mp3"] }
    ],
    "missing": ["a185b3d9-…"]
  }
}

पते केवल उन्हीं गानों के लौटते हैं जो आपने पहले डाउनलोड किए हैं; जिनका कोई डाउनलोड रिकॉर्ड नहीं या जिनकी फ़ाइलें वापस ले ली गई हैं, वे केवल missing में दिखते हैं और उनके लिए कोई पता नहीं लौटता।

नोट

• POST /api/music/free2 Suno के किसी भी सार्वजनिक गाने को निकाल सकता है (उन गानों सहित जो इस प्लेटफ़ॉर्म पर नहीं हैं); किसी गाने का निष्कर्षण विफल होने पर केवल उसी गाने के लिए error लौटता है और उसी बैच के बाकी गाने प्रभावित नहीं होते। वहीं POST /api/music/free2/cached केवल उन्हीं गानों के पते लौटाता है जो इस खाते ने डाउनलोड किए हैं।
• किसी गाने का पहला निष्कर्षण होस्ट की गई फ़ाइलें बनाता है, जिन्हें बाद में दोबारा उपयोग किया जाता है; files में एक ही प्रकार दो बार न भेजें, सर्वर स्वयं डुप्लीकेट हटा देता है।
• गाने की मीडिया डाउनलोड और प्रीव्यू API से अंतर: Free2 सशुल्क है, सीधे suno.com लिंक भेजने का समर्थन करता है, और गीत के अलावा टाइमलाइन/MIDI प्रकार नहीं देता।