API مسترینگ مجدد (Remaster)
توضیح نقطه پایانی
مسترینگ مجدد یک آهنگ کامل‌شده را به‌صورت «نسخه ریمستر» با کیفیت صدای بهتر بازتولید می‌کند. در هر فراخوانی 2 نسخه برمی‌گرداند و طرف بالادست به‌طور خودکار (Remastered) را به عنوان اضافه می‌کند.
نقطه پایانی: POST /api/music/remaster
صورت‌حساب: پرداختی و بر پایه مدل درخواستی (به‌طور پیش‌فرض suno-v6، 0.6 یوان برای هر فراخوانی)؛ مبلغی که واقعاً کسر می‌شود تابع پیکربندی قیمت در پنل مدیریت است.
درباره مدل: مسترینگ مجدد از یک نقطه پایانی اختصاصی بالادست و یک مدل ریمستر اختصاصی استفاده می‌کند که پلتفرم آن را ثابت تعیین کرده و با model تغییر نمی‌کند؛ model در درخواست فقط برای قیمت و انتخاب کانال است، پس توصیه می‌شود suno-v6 را صریح ارسال کنید.
زمان‌های انتظار و مهلت‌ها (مهم): این نقطه پایانی همزمان است — سفارش تنها زمانی پذیرفته و به ریمستر سپرده می‌شود که پاسخ برسد. مهلت سمت کلاینت را 300 ثانیه یا بیشتر بگذارید؛ نبود پاسخ به معنای ریمستر نشدن نیست، و بلافاصله پس از مهلت دوباره تلاش نکنید (سفارش را تکرار می‌کند و دوباره هزینه می‌گیرد). اگر اتصال قطع شد، بعداً با
GET /api/music/songsبررسی کنید.
احراز هویت
| پارامتر | نوع | الزامی | یادداشت |
|---|---|---|---|
| Authorization | string | بله | Bearer YOUR_API_KEY |
| Content-Type | string | بله | application/json |
پارامترهای درخواست
| پارامتر | نوع | الزامی | پیش‌فرض | یادداشت |
|---|---|---|---|---|
| song_id | string | بله | - | شناسه آهنگ منبع برای ریمستر؛ باید کامل شده و برای کلید API فعلی قابل دسترسی باشد |
| model | string | خیر | suno-v6 | نام مدل برای مشتری: suno-v6، suno-v6-wild یا suno-v6-mini؛ فقط برای قیمت و کانال |
| variation_category | string | خیر | normal | شدت تنوع: subtle، normal، high (مقدار قدیمی low معادل subtle) |
| style_profile | string | خیر | boost | سبک صدا: natural، boost، clarity |
| tags | string | خیر | - | فیلد رزروشده؛ اگر خالی نباشد به بالادست فرستاده می‌شود |
| source_audio_url | string | خیر | - | نشانی صدای منبع، وقتی آهنگ منبع از حساب خارجی آمده است |
| source_file_name | string | خیر | - | نام فایل منبع، وقتی آهنگ منبع از حساب خارجی آمده است |
| source_title | string | خیر | - | عنوان منبع، وقتی آهنگ منبع از حساب خارجی آمده است |
audio_id، source_clip_id و sourceClipId نوشتارهای معادل song_id هستند؛ هر یک را استفاده کنید.
نمونه درخواست
curl -X POST https://www.suno-api.io/api/music/remaster \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"song_id": "source_song_id",
"variation_category": "high",
"style_profile": "clarity"
}'
اگر مقادیر پیش‌فرض کافی است، فقط آهنگ منبع را بفرستید — معادل variation_category: normal + style_profile: boost:
{ "model": "suno-v6", "song_id": "source_song_id" }
پاسخ
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "remastered_clip_id_1",
"song_title": "عنوان آهنگ منبع (Remastered)",
"status": "processing"
},
{
"song_id": "remastered_clip_id_2",
"song_title": "عنوان آهنگ منبع (Remastered)",
"status": "processing"
}
]
}
}
هر فراخوانی 2 نسخه ریمستر برمی‌گرداند. هر دو clips[].song_id را ذخیره کنید و با API پرس‌وجوی آهنگ و تاریخچه تا رسیدن به complete پرس‌وجو کنید و سپس صدا را بگیرید.
نکات
- آهنگ منبع باید کامل شده و در محدوده دسترسی کلید API فعلی باشد؛ مواد منبع خارجی به‌طور خودکار به حساب اجراکننده همگام می‌شود.
- مسترینگ مجدد فقط کیفیت صدا را بازسازی می‌کند: برای تغییر سبک، تنظیم یا آواز از تقویت سبک، بارگذاری و سپس کاور یا نقاط پایانی Remix استفاده کنید.
- هرچه
variation_categoryبزرگ‌تر باشد، نسخه ریمستر بیشتر از آهنگ منبع فاصله می‌گیرد؛ پیش از تحویل واقعی ابتدا باnormalامتحان کنید و سپس بالا ببرید.
دریافت کلید API
پس از ثبت‌نام از کنسول یک کلید API بسازید. هر تولید ۰٫۶ یوان هزینه دارد و ۲ قطعه برمی‌گرداند، دانلودها نامحدود است و به شماره تلفن نیازی نیست.
دریافت کلید API بازگشت به مرور کلی