واجهة Extend (التمديد)

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

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

تمنحك Extend متابعة أغنية موجودة من نقطة زمنية محددة، وتُولِّد المقطع التالي.

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

الفوترة: مدفوع، وحالياً 0.6 يوان افتراضياً لكل طلب. والمبلغ المخصوم فعلاً يتبع إعداد الأسعار الحالي في لوحة الإدارة.

Max Mode / Variety: تدعم نقطة النهاية هذه المعاملين الاختياريين max_mode و variety (0-4). عند تشغيل max_mode يُحاسَب هذا الطلب بضعف السعر (0.6 → 1.2 يوان لكل طلب)، ولا يضيف variety أي تكلفة. والمعنى وطريقة الإرسال في قسم «المعاملات المتقدمة» من نظرة عامة على الواجهة الجديدة.

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

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

Headers

معاملات جسم الطلب

مثال الطلب

curl -X POST https://www.suno-api.io/api/music/extend \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "prompt": "تابع اللازمة بمشاعر أقوى",
    "continueAt": 60,
    "style": "Mandopop, rock",
    "negativeTags": "noise",
    "title": "النسخة الممدَّدة",
    "waitAudio": false
  }'

الاستجابة

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "extended_clip_id",
        "song_title": "النسخة الممدَّدة",
        "status": "pending"
      }
    ]
  }
}

الحقول المتوافقة

لا تزال أسماء الحقول القديمة مقبولة:

ملاحظات

• لا تضع نقطة البداية ملاصقة للنهاية: طول المقطع الممدَّد يساوي أساساً «ما تبقّى بعد نقطة البداية». وإذا كانت نقطة البداية قريبة جداً من النهاية فسيكون الناتج ثوانيَ قليلة — بالقياس، أغنية مدتها 242 ثانية مُدَّت من الثانية 240 فأنتجت 2.7 ثانية فقط (ومع ذلك يُحاسَب الطلب). اترك 10 ثوانٍ على الأقل بعد نقطة البداية.
• لا يوجد في Extend حد أدنى «للمصدر القصير جداً»: بالقياس، مقطع بطول 9.6 ثانية مُدَّ من الثانية 5 فأنتج أغنية بشكل طبيعي، لذا فقصر المصدر أو قصر المتبقي ليس سبباً للرفض.
• يجب أن تكون نقطة البداية أكبر من 0: قيمة continueAt=0 تُقبل من المنصة ثم تُبطَل، دون إرجاع سبب الفشل، لذا ابدأ مباشرة بعد الثانية الأولى.
• يعيد الطلب الواحد نتيجتين (تُحاسَب كأغنيتين)؛ فاعتمد على طول مصفوفة clips.
• الناتج عمل جديد؛ والأغنية الأصلية لا تتأثر.