API تقویت سبک

به‌روزرسانی 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 بازنویسی شود.