واجهة دمج الأغنية كاملة (Get Full Song)

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

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

دمج الأغنية كاملة يجمع «الأغنية الأصلية + المقطع المولَّد حديثاً» في أغنية واحدة كاملة: بعد Extend يُضاف المقطع التالي، وبعد Replace Section يُخاط المقطع الجديد مرة أخرى داخل الأصل. وتسمّي الواجهة الرسمية هذه القدرة Get Full Song.

نقطة النهاية: POST /api/music/concat

الفوترة: مدفوع، بمبلغ ثابت 0.05 يوان لكل طلب. الدمج منفصل عن سعر التوليد ولا يشارك في Max Mode ولا في مضاعفات الملف الصوتي؛ والمبلغ المخصوم فعلاً يتبع إعداد الأسعار في لوحة الإدارة.

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

المصادقة

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

audio_id و source_clip_id و sourceClipId صيغ مكافئة لـ song_id؛ استخدم أيّاً منها.

مثال الطلب

curl -X POST https://www.suno-api.io/api/music/concat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_id": "extended_or_replaced_clip_id",
    "is_infill": false
  }'

وللدمج بعد استبدال مقطع، اضبط is_infill على true:

{ "song_id": "infilled_clip_id", "is_infill": true }

الاستجابة

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "concat_clip_id",
        "song_title": "عنوان الأغنية المصدر",
        "status": "queued"
      }
    ]
  }
}

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

من أين تأتي مدة النتيجة

الدمج لا يلصق ملفين أحدهما بعد الآخر مباشرةً، بل يقصّ الأغنية المصدر وفق النقاط الزمنية المسجّلة في سجل المقطع:

ولذلك يُهمل الصوت الأصلي بعد نقطة التمديد، ولا يتكرر أي مقطع بالكامل.

ملاحظات

• لا يمكن دمج إلا المقاطع المكتملة؛ وإذا كان المقطع قيد التوليد فانتظر انتهاءه أولاً.
• النتيجة سجل جديد، وتبقى الأغنية المقطع الأصلية محفوظة وقابلة للاستخدام.
• لدمج أغنيتين مختلفتين في واحدة استخدم واجهة الدمج (Mashup)، وللاحتفاظ بمقطع واحد فقط استخدم واجهة الاقتطاع.