واجهة حذف المقطع

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

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

يحذف هذا الإجراء نطاقاً زمنياً من أغنية موجودة ويدمج الأجزاء المتبقية في نسخة جديدة.

نقطة النهاية: POST /api/music/remove-section

الفوترة: مدفوع، وتُحاسَب حسب النموذج المطلوب؛ والمبلغ المخصوم فعلاً يتبع إعداد الأسعار في لوحة الإدارة.

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

أوقات الانتظار والمهلات (مهم): هذه نقطة نهاية متزامنة — لا يُقبل الطلب ويُسلَّم إلى التوليد إلا عند وصول الاستجابة. ووفق القياس، تعود معظم الطلبات في 1-3 ثوانٍ، ونحو 10% تتجاوز 30 ثانية، وأطولها نحو 230 ثانية. اضبط مهلة العميل على 300 ثانية أو أكثر؛ وعدم وصول استجابة لا يعني عدم التوليد، ولا تُعد المحاولة فوراً بعد انتهاء المهلة (فذلك يكرر الطلب ويخصم مرة أخرى). وإن انقطع الاتصال فتحقق لاحقاً عبر GET /api/music/songs. راجع «أوقات الانتظار وإعدادات المهلة» في نظرة عامة على الواجهة الجديدة.

المصادقة

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

مثال الطلب

curl -X POST https://www.suno-api.io/api/music/remove-section \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "crop_start_s": 30,
    "crop_end_s": 45,
    "song_title": "النسخة بعد الحذف"
  }'

الاستجابة

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "النسخة بعد الحذف",
        "status": "processing"
      }
    ]
  }
}

يعيد الطلب الواحد نتيجة واحدة (إجراءات التحرير لا تُنتج أغنيتين). احفظ clips[].song_id ثم استعلم عبر واجهة استعلام الأغاني دورياً حتى تصل إلى completed.

ملاحظات

• يجب أن يحقق النطاق المحذوف 0 <= crop_start_s < crop_end_s وأن يقع داخل مدة الأغنية المصدر.
• للإبقاء على نطاق بدل حذفه استخدم واجهة Crop.