प्रॉम्प्ट सुझाव API

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

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

प्रॉम्प्ट सुझाव एंडपॉइंट यादृच्छिक गाना विवरण, बोल विषय और स्टाइल टैग सुझाव लौटाता है। यह "यादृच्छिक प्रेरणा" और "टैग रीफ़्रेश" बटन के लिए उपयुक्त है।

एंडपॉइंट: POST /api/prompts/suggestions

बिलिंग: कोटा के भीतर मुफ़्त (प्रति उपयोगकर्ता प्रति मिनट अधिकतम 10 कॉल और प्रति दिन 300); मुफ़्त कोटा पार करने पर प्रति कॉल 0.1 युआन।

सीमा पार होने की पहचान: मुफ़्त कोटा पार होने पर भी अनुरोध सामान्य रूप से चलता है, और प्रतिक्रिया हेडर में X-Suno-Helper-Free: false तथा X-Suno-Helper-Over-Limit: minute (या day) आते हैं, जिससे क्लाइंट बता सकता है कि इस कॉल पर शुल्क लगा है।

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

प्रमाणीकरण

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

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

curl -X POST https://www.suno-api.io/api/prompts/suggestions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6"
  }'

प्रतिक्रिया

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["रात, पुनर्मिलन और पछतावे पर हिन्दी बोल लिखें"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

फ़ील्ड विवरण