واجهة تعزيز الأسلوب

آخر تحديث 2026-09-18 · فريق Suno-API

وصف نقطة النهاية

يوسّع تعزيز الأسلوب وسم الأسلوب القصير إلى وصف أسلوب أكمل وأكثر ملاءمة لتوليد Suno، ويمكنه أيضاً توليد مقطع أسلوب من كلمات كاملة.

نقطة النهاية: POST /api/music/boost-style

الفوترة: مجاني داخل الحصة (بحد أقصى 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.

الإخراج بالصينية: عندما يحتوي محتوى الطلب (originalTags/lyrics/user_guidance) على الصينية ولم تُعلَن اللغة، تُضيف الخدمة تلقائياً （请用中文描述） بعد original_tags وترفق user_guidance=语言：简体中文；乐器名也用中文, لرفع دقة أوصاف الأسلوب بالصينية. وتُعاد القيم المُرسَلة فعلاً في appliedOriginalTags و appliedUserGuidance داخل الاستجابة. وإن كان المحتوى المرسل يذكر اللغة صراحةً (مثل «اشرح بالصينية المبسطة») فلن تُجري الخدمة أي تعديل.

المصادقة

معاملات الطلب

مثال الطلب

curl -X POST https://www.suno-api.io/api/music/boost-style \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "originalTags": "pop, piano, male vocal",
    "lyrics": "[Verse]\nالليل يهبط خارج النافذة\n[Chorus]\nنسير نحو النور",
    "user_guidance": "أضف السونا والإرهو، صوت رجل، إيقاع أسرع",
    "instrumental": false
  }'

الاستجابة

{
  "code": 200,
  "message": "success",
  "data": {
    "originalTags": "pop, piano, male vocal",
    "instrumental": false,
    "upsampledStyle": "Mandopop, expressive male vocal, warm piano ballad...",
    "requestId": "request_id"
  }
}

upsampledStyle هو وصف الأسلوب الكامل الذي ينبغي كتابته مرة أخرى في حقل Style.