API میکس (Mashup)
توضیح نقطه پایانی
میکس دو آهنگ کامل‌شده را در یک اثر جدید ترکیب می‌کند؛ ترتیب دو منبع حفظ می‌شود.
نقطه پایانی: POST /api/music/mashup
صورت‌حساب: پرداختی و بر پایه مدل درخواستی محاسبه می‌شود؛ مبلغی که واقعاً کسر می‌شود تابع پیکربندی قیمت در پنل مدیریت است.
Max Mode / Variety: این نقطه پایانی پارامترهای اختیاری max_mode و variety (0-4) را پشتیبانی می‌کند. با روشن بودن
max_mode این فراخوانی با قیمت دوبرابر محاسبه می‌شود؛ variety هزینه‌ای اضافه ندارد. معنی آن‌ها و روش ارسال
در بخش «پارامترهای پیشرفته» مرور کلی API جدید آمده است.
مدل پیشنهادی: suno-v6. می‌توان از suno-v6، suno-v6-wild و suno-v6-mini استفاده کرد.
زمان‌های انتظار و مهلت‌ها (مهم): این نقطه پایانی همزمان است — سفارش تنها زمانی پذیرفته و به تولید سپرده می‌شود که پاسخ برسد. بر پایه اندازه‌گیری، بیشتر درخواست‌ها در 1-3 ثانیه پاسخ می‌دهند، حدود 10% بیش از 30 ثانیه طول می‌کشند و طولانی‌ترین حدود 230 ثانیه است. مهلت سمت کلاینت را 300 ثانیه یا بیشتر بگذارید؛ نبود پاسخ به معنای تولید نشدن نیست، و بلافاصله پس از مهلت دوباره تلاش نکنید (سفارش را تکرار می‌کند و دوباره هزینه می‌گیرد). اگر اتصال قطع شد، بعداً با
GET /api/music/songsبررسی کنید. بخش «زمان‌های انتظار و تنظیم مهلت» در مرور کلی API جدید را ببینید.
احراز هویت
| پارامتر | نوع | الزامی | یادداشت |
|---|---|---|---|
| Authorization | string | بله | Bearer YOUR_API_KEY |
| Content-Type | string | بله | application/json |
پارامترهای درخواست
| پارامتر | نوع | الزامی | پیش‌فرض | یادداشت |
|---|---|---|---|---|
| model | string | بله | - | نام مدل برای مشتری: suno-v6، suno-v6-wild یا suno-v6-mini |
| mashup_clip_ids | array | بله | - | دقیقاً دو song_id واقعی و متفاوت؛ ترتیب حفظ می‌شود |
| lyrics | string | خیر | - | متن یا جهت خلاقانه |
| style_tags | string | خیر | - | برچسب‌های سبک |
| song_title | string | خیر | - | عنوان نتیجه |
| negative_tags | string | خیر | - | برچسب‌های سبک حذف‌شده |
| instrumental | boolean | خیر | false | آیا نتیجه بی‌کلام است |
| wait_completion | boolean | خیر | false | آیا مدت بیشتری پیش از پاسخ صبر کند |
نمونه درخواست
curl -X POST https://www.suno-api.io/api/music/mashup \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"mashup_clip_ids": ["source_song_id_a", "source_song_id_b"],
"style_tags": "electronic pop, energetic",
"song_title": "نسخه میکس",
"wait_completion": false
}'
پاسخ
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "result_song_id",
"song_title": "نسخه میکس",
"status": "pending"
},
{
"song_id": "result_song_id_2",
"song_title": "نسخه میکس",
"status": "pending"
}
]
}
}
یک فراخوانی 2 نتیجه برمی‌گرداند (به‌عنوان 2 آهنگ حساب می‌شود)؛ نمونه دو مورد را نشان می‌دهد. ملاک طول آرایه clips است و حلقه با تعداد ثابت ننویسید. مقدار clips[].song_id را ذخیره کنید و با API پرس‌وجوی آهنگ و تاریخچه تا رسیدن به completed پرس‌وجو کنید.
نکات
mashup_clip_idsباید دقیقاً دو شناسه واقعی و متفاوت آهنگ داشته باشد.- هر دو منبع باید کامل شده و برای کلید API فعلی قابل دسترسی باشند؛ اگر منبعی در دسترس نباشد، پیش از تولید خطا برگردانده می‌شود.
دریافت کلید API
پس از ثبت‌نام از کنسول یک کلید API بسازید. هر تولید ۰٫۶ یوان هزینه دارد و ۲ قطعه برمی‌گرداند، دانلودها نامحدود است و به شماره تلفن نیازی نیست.
دریافت کلید API بازگشت به مرور کلی