واجهة إعادة الماستر (Remaster)

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

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

إعادة الماستر تُعيد توليد أغنية مكتملة على شكل «نسخة معاد ماسترتها» بجودة صوت أفضل. وتُعيد نسختين في المرة الواحدة، ويُضيف الطرف الأعلى (Remastered) إلى العنوان تلقائياً.

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

الفوترة: مدفوع، وتُحاسَب حسب النموذج المطلوب (افتراضياً suno-v6، 0.6 يوان لكل طلب)؛ والمبلغ المخصوم فعلاً يتبع إعداد الأسعار في لوحة الإدارة.

حول النموذج: تستخدم إعادة الماستر نقطة نهاية خاصة لدى الطرف الأعلى ونموذجاً مخصّصاً ثابتاً تحددها المنصة ولا يتغير بحسب model؛ أما model في الطلب فيُستخدم فقط للتسعير واختيار القناة، ويُستحسن تمرير suno-v6 صراحةً.

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

المصادقة

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

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

مثال الطلب

curl -X POST https://www.suno-api.io/api/music/remaster \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "song_id": "source_song_id",
    "variation_category": "high",
    "style_profile": "clarity"
  }'

إذا كانت القيم الافتراضية كافية، أرسل الأغنية المصدر فقط — وهذا يعادل variation_category: normal + style_profile: boost:

{ "model": "suno-v6", "song_id": "source_song_id" }

الاستجابة

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "remastered_clip_id_1",
        "song_title": "عنوان الأغنية المصدر (Remastered)",
        "status": "processing"
      },
      {
        "song_id": "remastered_clip_id_2",
        "song_title": "عنوان الأغنية المصدر (Remastered)",
        "status": "processing"
      }
    ]
  }
}

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

ملاحظات

• يجب أن تكون الأغنية المصدر مكتملة وضمن نطاق وصول مفتاح API الحالي؛ وتُزامَن المواد المصدر الخارجية مع الحساب المنفِّذ تلقائياً.
• إعادة الماستر تُعيد جودة الصوت فقط: لتغيير الأسلوب أو التوزيع أو الغناء استخدم تقوية الأسلوب أو الرفع ثم الكوفر أو واجهات Remix.
• كلما زادت variation_category زاد اختلاف النسخة المعاد ماسترتها عن الأغنية المصدر؛ وقبل التسليم الفعلي جرّب normal ثم ارفع القيمة.