واجهة اقتراحات البرومبت

آخر تحديث 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
  }
}

وصف الحقول