واجهة إزالة الغناء

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

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

إزالة الغناء تقسم أغنية موجودة إلى مسارين: الغناء والموسيقى المصاحبة. وهي الصيغة المختصرة للفصل: يكفي تمرير معرّف الأغنية المصدر، دون الحاجة لاختيار وضع الفصل، ويعالج الخادم دائماً كمسارين (two).

نقطة النهاية: POST /api/music/vocal-removal

الفوترة: مجاني. هذه الواجهة تقوم بفصل المسارات فقط، ولا تُنتج أي تكلفة توليد، ولا تُنشئ أي سجل خصم.

النموذج الموصى به: suno-v6. ويتوفر suno-v6 و suno-v6-wild و suno-v6-mini.

المصادقة

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

أسماء بديلة متوافقة: يمكن استخدام sourceClipId أو audio_id أو audioId أو song_id بدلاً من source_clip_id.

مثال الطلب

curl -X POST https://www.suno-api.io/api/music/vocal-removal \
  -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": "vocals_clip_id",
        "song_title": "إزالة الغناء (Vocals)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      },
      {
        "song_id": "instrumental_clip_id",
        "song_title": "إزالة الغناء (Instrumental)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      }
    ]
  }
}

الطلب الواحد يعيد نسختين × {Vocals, Instrumental}، لذلك تحتوي clips عادةً على 4 عناصر. اجمع حسب stem_from_id، وميّز الغناء من الموسيقى المصاحبة بلاحقة song_title.

ملاحظات

• استعلم عن المسارات الناتجة عبر واجهة استعلام الأغاني والسجل (POST /api/music/query) حتى تصل إلى completed قبل استخدامها؛ وGET /api/music/songs/:song_id وقائمة السجل لا تشمل حالياً المسارات التي تنتجها إزالة الغناء — وهذا فرق معروف.
• إذا أردت اختيار وضع المسارين أو عدة مسارات، أو الفصل حسب اسم المسار، فاستخدم واجهة الفصل (الغناء والموسيقى المصاحبة).
• يمكن إخفاء المسارات غير المرغوبة عبر واجهة حذف المسار؛ ولا تُكرر إرسال طلبات الحذف.