واجهة Speed (تغيير السرعة)

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

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

تغيّر Speed سرعة تشغيل أغنية موجودة، مع خيار الحفاظ على طبقة الصوت.

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

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

النموذج الموصى به: 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/speed \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "speed_multiplier": 1.2,
    "keep_pitch": true,
    "song_title": "النسخة بعد تغيير السرعة"
  }'

الاستجابة

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "النسخة بعد تغيير السرعة",
        "status": "processing"
      }
    ]
  }
}

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

ملاحظات

• يجب أن يكون speed_multiplier موجباً وبحد أقصى أربع منازل عشرية؛ وأكثر من ذلك يعيد HTTP 400 قبل أي خصم.
• مدة النتيجة تساوي تقريباً المدة الأصلية مقسومة على مضاعف السرعة.