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

تتوفر Seedance 2.5 على NeuralSpace ليس فقط عبر واجهة الويب، بل أيضاً من خلال الواجهة البرمجية العامة /v1 وخادم بروتوكول سياق النموذج (MCP). يمكن للمطورين ووكلاء الذكاء الاصطناعي توليد الفيديو مباشرة عبر الأكواد البرمجية: إرسال مطالبات نصية، وتمرير مراجع الصور والفيديو، وتحديد المدة، وسحب الملف الجاهز عبر رابط مباشر.

كيف تعمل الواجهة البرمجية

يستغرق توليد الفيديو دقائق، لذا فالواجهة غير متزامنة. أولاً ترسل طلب POST لإنشاء مهمة — تخصم الخدمة الرموز فوراً بناءً على التسعيرة وتعيد معرّف المهمة. ثم تستطلع حالة المهمة، وعندما يكتمل المقطع تحصل على رابط مباشر لملف الفيديو. عند حدوث خطأ أو انتهاء المهلة تُعاد الرموز تلقائياً. تُصدر المفاتيح في لوحة التحكم ضمن قسم مفاتيح API.

نقاط النهاية البرمجية

أنشئ مهمة عبر POST /v1/videos/generations بجسم { model: "seedance-2.5", prompt, duration, resolution, aspect_ratio, image_urls, video_urls, audio_urls }. الحالة والنتيجة تأتيان من GET /v1/videos/generations/:id. القائمة الكاملة للنماذج والأسعار الحية متاحة في توثيق الواجهة البرمجية وعبر GET /v1/models.

الاتصال عبر بروتوكول MCP (Model Context Protocol)

بالنسبة لتطبيقات مثل Claude Desktop و Cursor و Cline ووكلاء الذكاء الاصطناعي، يوفر NeuralSpace خادم MCP رسمي عبر https://neuralspace.pro/mcp. نموذج Seedance 2.5 مدعوم في أداة generate_video مع إمكانية متابعة الحالة عبر check_video. يكفي أن يحدد الوكيل model: "seedance-2.5" مع الوصف المطلوب لتوليد الفيديو في الخلفية من رصيد الحساب.

{
  "mcpServers": {
    "neuralspace": {
      "url": "https://neuralspace.pro/mcp",
      "headers": {
        "x-api-key": "nsk-مفتاحك"
      }
    }
  }
}

إمكانات Seedance 2.5

في الواجهة البرمجية وMCP، يتوفر النموذج بالمعرّف seedance-2.5. يدعم دقة 480p و 720p و 1080p، ومدداً من 4 إلى 30 ثانية، وتوليد الصوت، ونسب الأبعاد المختلفة (16:9، 9:16، 1:1، 4:3، 3:4، 21:9، أو التكيفي)، بالإضافة إلى مراجع الصور والفيديو. يمكنك تجربة الإعدادات قبل التكامل عبر صفحة النموذج.

مثال طلب عبر cURL

إنشاء مهمة توليد عبر الواجهة البرمجية العامة:

curl https://neuralspace.pro/v1/videos/generations \
  -H "x-api-key: nsk-مفتاحك" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "لقطة قريبة لبلورة مستقبلية على طاولة داكنة، إضاءة نيون ناعمة، حركة سينمائية",
    "duration": 5,
    "resolution": "720p"
  }'

يعيد الرد معرّف id للمهمة وحالة pending. استطلاع النتيجة:

curl https://neuralspace.pro/v1/videos/generations/TASK_ID \
  -H "x-api-key: nsk-مفتاحك"

عند اكتمال المهمة، يحتوي الرد على رابط الفيديو في الحقل data[0].url.

أسئلة شائعة

هل Seedance 2.5 متاحة عبر API و MCP؟

نعم، تتوفر Seedance 2.5 بالكامل في الواجهة البرمجية REST (المعرّف seedance-2.5) وعبر خادم MCP الرسمي في أداة generate_video. التفاصيل في توثيق الواجهة.

كيف أحصل على مفتاح API؟

يُصدر المفتاح فوراً في لوحة تحكم NeuralSpace ضمن صفحة مفاتيح API.

كم تكلف التوليدة عبر الواجهة البرمجية؟

الفوترة بالثانية وتطابق الموقع حسب الدقة (480p أو 720p أو 1080p). تظهر الأسعار المباشرة في GET /v1/models و /v1/docs.