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

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

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

تولّد Veo 3.1 فيديو من النص بسعر ثابت للمقطع. تتوفر ثلاث نسخ: Quality وFast وLite، تختلف في الجودة والسعر. تُدعم نسبتا الأبعاد 16:9 و9:16، وعبر image_urls يمكن تمرير صورة مصدر للتحويل من صورة إلى فيديو.

نقطة النهاية

يُرسل الطلب إلى POST /v1/videos/generations. مثال: {"model": "veo-3.1", "prompt": "شارع مدينة ليلاً، تتحرك الكاميرا ببطء", "aspect_ratio": "16:9"}. التفويض عبر مفتاح API في ترويسة x-api-key. معرّفات النماذج المتاحة: veo-3.1, veo-3.1-fast, veo-3.1-lite.

أدوات MCP

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

كيف تربط

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

أسئلة شائعة

كيف يختلف Quality عن Lite؟

يمنح Quality أفضل جودة، وLite أسرع وأرخص، وFast هو التوازن.

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

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

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

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