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

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

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

تولّد Sora 2 فيديو من النص، ويعتمد السعر على المدة (10 أو 15 ثانية). وتقدم Sora 2 Pro إضافةً جودة standard أو high. تُدعم الاتجاهات landscape وportrait، وعبر image_urls يمكن تمرير صورة مصدر للتحويل من صورة إلى فيديو.

نقطة النهاية

يُرسل الطلب إلى POST /v1/videos/generations. مثال: {"model": "sora-2", "prompt": "أمواج على الشاطئ عند الغروب", "duration": 10, "aspect_ratio": "landscape"}. التفويض عبر مفتاح API في ترويسة x-api-key. معرّفات النماذج المتاحة: sora-2, sora-2-pro.

أدوات MCP

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

كيف تربط

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

أسئلة شائعة

ما المدد المتاحة؟

10 و15 ثانية.

كيف يختلف Pro عن النسخة العادية؟

يتيح Pro إضافةً اختيار جودة standard أو high.

هل يدعم المراجع؟

نعم، صورة-إلى-فيديو عبر image_urls.