واجهة حذف المسارات

آخر تحديث 2026-09-18 · فريق Suno-API

وصف نقطة النهاية

يخفي حذف المسارات مسارات الاستم العديدة المُولَّدة من القائمة. والحذف حذف منطقي: لا يفعل الخادم سوى وسم صفوف الاستم بـ stem_hidden؛ ويبقى الصوت و MIDI وموارد التنزيل كما هي، ويمكن فصل الأغنية نفسها مرة أخرى إلى مسارات جديدة لاحقاً.

نقطة النهاية: POST /api/music/stem-delete

الفوترة: مجاني. الحذف يحدّث حالة الظهور داخل المنصة فقط، ولا يستدعي Suno ولا ينتج أي خصم.

النموذج الموصى به: suno-v6. ويتوفر suno-v6 و suno-v6-wild و suno-v6-mini.

المصادقة

معاملات الطلب

يجب تقديم واحد على الأقل من 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
  }
}

ملاحظات

• العملية متكررة الأمان (idempotent): إن كان المسار مخفياً بالفعل أو كان المعرّف غير موجود فالرد hidden: 0 دون خطأ، فتکرار الطلب آمن.
• الحذف يؤثر فقط على أغاني مفتاح API الحالي؛ والمسارات التي لا تخصك لا تتغير.
• عند إخفاء آخر مسار ظاهر في القائمة تُمسح معه علامة «تم الفصل» على الأغنية المصدر.