مدل‌های پشتیبانی‌شده

به‌روزرسانی 2026-09-18 · تیم Suno-API

مدل‌های ساخت در دسترس

درخواست‌ها تنها نام مدل‌های پلتفرم را که در ادامه آمده می‌پذیرند. نام‌های دیگر، از جمله نام‌های شبیه به مدل موجود، پذیرفته نمی‌شوند.

مدل پیش‌فرض پیشنهادی: suno-v6.

درباره جداسازی استم

جداسازی استم یک قابلیت ثابت و مستقل است: نیازی به انتخاب مدل ساخت نیست. فقط آهنگ اصلی و حالت جداسازی (مثلاً two یا twelve) را بفرستید. تعداد مسیرهای بازگشتی همان است که پاسخ اعلام می‌کند.

پارامتر model

در نقاط پایانی ساخت، model معمولاً اختیاری است:

• خالی: مقدار پیش‌فرض suno-v6 استفاده می‌شود.
• مقدار داده‌شده: باید suno-v6 یا suno-v6-wild یا suno-v6-mini باشد.
• تنها نام مدل‌های جدول بالا پذیرفته می‌شوند.

کمینه نمونه ساخت

curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 300 \
  -d '{
    "description": "یک آهنگ فولک شاد درباره نخستین روز بهار",
    "model": "suno-v6"
  }'

زمان‌های انتظار و مهلت‌ها (مهم): نقاط پایانی تولید همزمان‌اند — سفارش تنها زمانی پذیرفته و به تولید سپرده می‌شود که پاسخ برسد. بر پایه اندازه‌گیری، بیشتر درخواست‌ها در 1-3 ثانیه پاسخ می‌دهند، حدود 10% بیش از 30 ثانیه طول می‌کشند و طولانی‌ترین حدود 230 ثانیه است. مهلت سمت کلاینت را 300 ثانیه یا بیشتر بگذارید (--max-time 300 در نمونه)؛ نبود پاسخ به معنای تولید نشدن نیست، و بلافاصله پس از مهلت دوباره تلاش نکنید (سفارش را تکرار می‌کند و دوباره هزینه می‌گیرد). اگر اتصال قطع شد، بعداً با GET /api/music/songs بررسی کنید. بخش «زمان‌های انتظار و تنظیم مهلت» در مرور کلی API جدید را ببینید.

نمونه با یکی از گونه‌های V6

{
  "model": "suno-v6-wild",
  "description": "یک قطعه الکترونیک با ساختار آزمایشی"
}

مدل‌های غیرفعال

این مدل‌ها دیگر درخواست جدید نمی‌پذیرند:

• suno-v2
• suno-v3
• suno-v3-5
• suno-v4
• suno-v4-5
• suno-v4-5-all
• suno-v4-5-plus
• suno-v5
• suno-v5-5

آهنگ‌ها و کارهای قدیمی ممکن است هنوز model_name یا model_version قدیمی را نشان دهند. این داده تاریخی است و به معنای پذیرش درخواست جدید توسط مدل قدیمی نیست.

برای سازگاری با کلاینت‌های موجود، درخواستی که مدل غیرفعال را ذکر کند با مدل پیش‌فرض فعلی suno-v6 پردازش می‌شود، نه اینکه رد شود. کار نیز با suno-v6 ثبت می‌شود و خطای «مدل در دسترس نیست» بازگردانده نمی‌شود. با این حال، نمونه‌های خود را در سریع‌ترین زمان به نام‌های فعلی به‌روز کنید.

فهرست مدل‌ها

GET /v1/models باید دست‌کم این مدل‌های موسیقی را در بر بگیرد:

{
  "object": "list",
  "data": [
    { "id": "suno-v6", "object": "model", "owned_by": "suno" },
    { "id": "suno-v6-wild", "object": "model", "owned_by": "suno" },
    { "id": "suno-v6-mini", "object": "model", "owned_by": "suno" }
  ]
}

پاسخ ممکن است مدل‌های متن، مسیرهای سازگاری یا مدل‌های درونی را هم شامل شود. آن‌ها را با مدل‌های V6 برای ساخت موسیقی اشتباه نگیرید.

انتخاب گونه V6

در بیشتر یکپارچه‌سازی‌ها مدل پیش‌فرض کافی است. سه گونه در وفاداری به پرامپت و میزان تنوع نتیجه تفاوت دارند.

چون هر اجرا دو قطعه برمی‌گرداند، روش عملی این است که با suno-v6-mini طرح اولیه بگیرید و سپس پرامپت تأییدشده را با suno-v6 اجرا کنید تا نسخه انتشار را انتخاب کنید.

هزینه و بازگشت

هزینه بر پایه درخواست است، نه مدل: هر اجرا ۰,۶ ¥ هزینه دارد و دو قطعه برمی‌گرداند. ساخت‌های ناموفق خودکار بازگردانده می‌شوند، پس تلاش ناموفق موجودی مصرف نمی‌کند. دانلود نامحدود است و هرگز جداگانه محاسبه نمی‌شود.