واجهة Suno البرمجية وMCP: كيف تضيف توليد الموسيقى إلى مشروعك

Suno عائلة من نماذج توليد الموسيقى. تتوفر على NeuralSpace النماذج: Suno V5.5, Suno V5, Suno V4.5+, Suno V4.5, Suno V4. تعمل جميعها عبر واجهة برمجية عامة واحدة، وهناك خادم MCP جاهز لوكلاء الذكاء الاصطناعي. يُصدر المفتاح من صفحة مفاتيح API. فيما يلي قدرات النموذج وأمثلة الطلبات وطريقة الإعداد.

ماذا يستطيع Suno فعله؟

تولّد Suno موسيقى من وصف نصي، عادةً مقطعان لكل توليدة. تتوفر النسخ V5.5 وV5 وV4.5+ وV4.5 وV4. يوجد وضع عادي بالوصف ووضع مخصص بكلمات الأغنية والأسلوب والعنوان. التوليد غير متزامن: تُستطلع الحالة عبر GET /v1/music/generations/:id.

نقطة النهاية

يُرسل الطلب إلى POST /v1/music/generations. مثال: {"model": "V5_5", "prompt": "لحن هادئ بدون كلمات للخلفية", "instrumental": true}. التفويض عبر مفتاح API في ترويسة x-api-key. معرّفات النماذج المتاحة: V5_5, V5, V4_5PLUS, V4_5, V4.

أدوات MCP

يتوفر خادم MCP الخاص بـNeuralSpace على POST /mcp (Streamable HTTP). للعمل مع Suno يستخدم الوكيل الأدوات: generate_music, check_music, list_models, get_balance. يتيح ذلك لـClaude Code وCursor وغيرها من عملاء MCP استخدام نماذج الموقع مباشرة.

كيف تربط

سجّل في NeuralSpace، وافتح صفحة مفاتيح API وأنشئ مفتاحاً بصيغة nsk-…. ثم مرّره في ترويسة الطلب أو في إعدادات عميل MCP. التوثيق الكامل على صفحة /v1/docs.

أسئلة شائعة

كم مقطعاً يأتي لكل توليدة؟

عادةً مقطعان لكل توليدة.

هل يمكن تقديم كلمات الأغنية؟

نعم، في الوضع المخصص تُمرَّر كلمات الأغنية والأسلوب والعنوان.

ما صيغة الطلب؟

POST /v1/music/generations مع حقلي model وprompt.