واجهة Reverse (العكس)

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

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

تُشغِّل Reverse أغنية موجودة بالعكس وتُولِّد نسخة جديدة.

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

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

النموذج الموصى به: 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/reverse \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "song_title": "النسخة المعكوسة"
  }'

الاستجابة

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "النسخة المعكوسة",
        "status": "processing"
      }
    ]
  }
}

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

ملاحظات

• يجب أن يكون source_clip_id معرّف أغنية حقيقياً ومكتملاً ومتاحاً لمفتاح API الحالي.
• مدة النتيجة تطابق عادةً الأغنية المصدر.