API حذف استم‌ها
توضیح نقطه پایانی
حذف استم‌ها ترک‌های استم تولیدشده را از فهرست پنهان می‌کند. حذف نرم است: بک‌اند فقط ردیف‌های استم را با
stem_hidden علامت می‌زند؛ خودِ فایل صوتی، MIDI و منابع دانلود باقی می‌مانند و همان آهنگ بعداً می‌تواند دوباره به استم‌های جدید جدا شود.
نقطه پایانی: POST /api/music/stem-delete
صورت‌حساب: رایگان. حذف فقط وضعیت نمایش درون پلتفرم را به‌روز می‌کند، Suno را فراخوانی نمی‌کند و هزینه‌ای ایجاد نمی‌کند.
مدل پیشنهادی: suno-v6. می‌توان از suno-v6، suno-v6-wild و suno-v6-mini استفاده کرد.
احراز هویت
| پارامتر | نوع | الزامی | یادداشت |
|---|---|---|---|
| Authorization | string | بله | Bearer YOUR_API_KEY |
| Content-Type | string | بله | application/json |
پارامترهای درخواست
| پارامتر | نوع | الزامی | پیش‌فرض | یادداشت |
|---|---|---|---|---|
| song_id | string | خیر | - | song_id یک ترک استم (شناسه‌ای که /api/music/separate برمی‌گرداند) |
| song_ids | string[] | خیر | - | شکل دسته‌ای، حداکثر 100 در هر فراخوانی |
| stem_batch_id | string | خیر | - | حذف بر پایه دسته: همه ترک‌های آن دسته جداسازی خودکار را حذف می‌کند |
| stem_mode | string | خیر | - | حذف بر پایه حالت، مانند two و twelve |
باید حداقل یکی از song_id / song_ids / stem_batch_id / stem_mode فرستاده شود، وگرنه پاسخ 400 است.
نمونه درخواست
curl -X POST https://www.suno-api.io/api/music/stem-delete \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"song_ids": ["stem_track_id_1", "stem_track_id_2"]
}'
پاسخ
{
"code": 200,
"message": "success",
"data": {
"hidden": 2,
"affected_sources": 1
}
}
| فیلد | نوع | یادداشت |
|---|---|---|
| hidden | number | تعداد ترک‌هایی که در این فراخوانی پنهان شد |
| affected_sources | number | تعداد آهنگ‌های منبع متأثر |
نکات
- خودتکرار (idempotent): اگر ترک پیش‌تر پنهان شده یا شناسه وجود نداشته باشد، پاسخ
hidden: 0است و خطایی نمی‌دهد، پس تکرار فراخوانی بی‌خطر است. - حذف فقط روی آهنگ‌های کلید API فعلی اثر دارد؛ ترک‌هایی که مال شما نیستند تغییر نمی‌کنند.
- وقتی آخرین استم قابل‌مشاهده در فهرست پنهان شود، نشانه «جدا شده» آهنگ منبع هم پاک می‌شود.
دریافت کلید API
پس از ثبت‌نام از کنسول یک کلید API بسازید. هر تولید ۰٫۶ یوان هزینه دارد و ۲ قطعه برمی‌گرداند، دانلودها نامحدود است و به شماره تلفن نیازی نیست.
دریافت کلید API بازگشت به مرور کلی