آخر تحديث 2026-10-26
خادم MCP لتوليد الفيديو بالذكاء الاصطناعي
مع VidFlux MCP ينشئ Claude وCursor وCodex وغيرها من وكلاء الذكاء الاصطناعي مقاطع الفيديو مباشرة داخل المحادثة. صِل خادمًا واحدًا عن بُعد واستخدم 16 نموذج فيديو، منها Veo 3.1 وKling 3.0 وSeedance 2.0 و2.5 وHailuo H3 وGemini Omni، إضافة إلى GPT Image وNano Banana للإطارات الرئيسية. كل شيء يُحتسب بالرصيد حسب الاستخدام دون اشتراك إلزامي.
- نقطة الاتصال:
https://vidflux.ai/api/mcp - طريقة الاتصال: Streamable HTTP (عن بُعد، دون أي تثبيت)
- المصادقة:
Authorization: Bearer vf_… - النماذج: 16 نموذج فيديو و5 نماذج صور
- التطبيقات المدعومة: Claude Code, Claude Desktop, Cursor, Codex CLI, VS Code, Windsurf, Cline
- الأسعار: تبدأ من 500 رصيد مقابل 4.98 دولار، مع استرداد المهام الفاشلة
ما هو خادم VidFlux MCP للفيديو؟
بروتوكول Model Context Protocol (MCP) هو المعيار المفتوح الذي تستخدمه مساعدات الذكاء الاصطناعي لاستدعاء الأدوات الخارجية. VidFlux MCP نقطة اتصال مستضافة تمنح مساعدك أدوات الفيديو: بدء توليد من نص إلى فيديو أو من صورة إلى فيديو أو بالتحكم في الحركة، ومتابعة التقدم، واستلام ملف MP4 النهائي. يكتب المساعد الوصف، ويختار النموذج والمدة ونسبة العرض، وينتظر انتهاء المعالجة، ثم يسلّمك الملف دون أن تغادر المحادثة أو المحرر.
خلف نقطة الاتصال يعمل نفس نظام مولّد الفيديو في vidflux.ai، لذا تبقى إصدارات النماذج والأسعار وقواعد الاسترداد متطابقة، وتظهر كل مهمة أيضًا في سجل حسابك.
نماذج الفيديو المدعومة
مرّر معرّف النموذج في الوسيط model. الرصيد المذكور للإعدادات الافتراضية؛ الفيديو الأطول أو الأعلى دقة أو المزوّد بالصوت يكلّف أكثر، ويعيد dry_run السعر الدقيق لأي إعدادات.
| النموذج | معرّف النموذج | المدة | الدقة | الصوت | المدخلات | الرصيد |
|---|---|---|---|---|---|---|
| Seedance 2.0 | seedance-2 | 4–15 s | 480p · 720p | ✓ | نص وصورة وصور مرجعية | 680 |
| Seedance 2.0 Fast | seedance-2-fast | 4–15 s | 480p · 720p | ✓ | نص وصورة وصور مرجعية | 544 |
| Seedance 2.0 Mini | seedance-2-mini | 4–15 s | 480p · 720p | ✓ | نص وصورة وصور مرجعية | 360 |
| Seedance 2.5 | seedance-2.5 | 4–30 s | 480p · 720p | ✓ | نص وصورة وصور مرجعية | 704 |
| Seedance 1.0 Pro | seedance-1-pro | 5 · 10 s | 480p · 720p · 1080p | — | نص وصورة | 100 |
| Kling 3.0 Standard | kling-3 | 3–15 s | — | ✓ | نص وصورة | 200 |
| Kling 3.0 Pro | kling-3-pro | 3–15 s | — | ✓ | نص وصورة | 300 |
| Kling 2.6 | kling-2.6 | 5 · 10 s | — | ✓ | نص وصورة | 150 |
| Kling 2.5 Turbo | kling-2.5 | 5 · 10 s | — | — | نص وصورة | 110 |
| Kling 3.0 Motion Control | kling-3-motion | ≤ 30 s | 720p · 1080p | — | فيديو وصورة | 200 |
| Kling 2.6 Motion Control | kling-2.6-motion | ≤ 30 s | 720p · 1080p | — | فيديو وصورة | 125 |
| Veo 3.1 Quality | veo-3.1 | 8 s | — | ✓ | نص وصورة | 280 |
| Veo 3.1 Fast | veo-3.1-fast | 8 s | — | ✓ | نص وصورة | 120 |
| MiniMax Hailuo H3 | minimax-h3 | 4–15 s | 720p · 2K | — | نص وصورة وصور مرجعية | 175 |
| Gemini Omni Video | gemini-omni-video | 4–10 s | 720p · 1080p · 4K | — | نص وصور مرجعية | 200 |
| Grok Imagineلأعضاء Pro فقط | grok-imagine | 6 s | — | — | نص وصورة وصور مرجعية | 96 |
نماذج الصور للإطارات الرئيسية والصور المصغّرة
أنشئ أو عدّل الإطار الأول وصور المنتجات والصور المصغّرة، ثم حرّكها بأي نموذج تحويل صورة إلى فيديو من الجدول أعلاه.
| النموذج | معرّف النموذج | الدقة | الحد الأقصى للصور المرجعية | الرصيد |
|---|---|---|---|---|
| GPT Image 2.5 | gpt-image-2.5 | 1K · 2K · 4K | 16 | 20 |
| GPT Image 2 | gpt-image-2 | 1K · 2K · 4K | 16 | 20 |
| Nano Banana Pro | nano-banana-pro | 1K · 2K · 4K | 10 | 100 |
| Nano Banana 2.1 | nano-banana-2.1 | 1K · 2K · 4K | 10 | 15 |
| Nano Banana 2 | nano-banana-2 | 1K · 2K · 4K | 14 | 30 |
بداية سريعة: اتصل في 3 خطوات
- سجّل الدخول إلى VidFlux وأنشئ مفتاحًا من الإعدادات ← API & MCP. تحصل الحسابات الجديدة على رصيد تجريبي مجاني.
- أضف الخادم إلى تطبيق الذكاء الاصطناعي لديك باستخدام أحد الإعدادات أدناه.
- اطلب فيديو، مثلًا: «اصنع بـ Seedance 2 فيديو مدته 5 ثوانٍ بنسبة 9:16 لصبّ قهوة لاتيه بالحركة البطيئة واحفظه في ./assets».
إعداد تطبيقات MCP
استبدل vf_your_api_key بمفتاحك. في التطبيقات التي تقرأ متغيرات البيئة، احفظ المفتاح في VIDFLUX_API_KEY بدلًا من كتابته في ملف الإعدادات.
Claude Code
claude mcp add --transport http vidflux https://vidflux.ai/api/mcp \ --header "Authorization: Bearer vf_your_api_key" # verify claude mcp list
Claude Desktop
يتصل Claude Desktop بالخوادم البعيدة بمفتاح API عبر mcp-remote (يتطلب Node.js). عدّل claude_desktop_config.json ثم أعد تشغيل Claude:
{
"mcpServers": {
"vidflux": {
"command": "npx",
"args": [
"-y", "mcp-remote", "https://vidflux.ai/api/mcp",
"--header", "Authorization: Bearer vf_your_api_key"
]
}
}
}Cursor
أضف ما يلي إلى ~/.cursor/mcp.json (لكل المشاريع) أو .cursor/mcp.json (لمشروع واحد):
{
"mcpServers": {
"vidflux": {
"url": "https://vidflux.ai/api/mcp",
"headers": { "Authorization": "Bearer vf_your_api_key" }
}
}
}OpenAI Codex CLI
export VIDFLUX_API_KEY=vf_your_api_key codex mcp add vidflux --url https://vidflux.ai/api/mcp \ --bearer-token-env-var VIDFLUX_API_KEY
VS Code (GitHub Copilot agent mode)
أضف ما يلي إلى .vscode/mcp.json:
{
"servers": {
"vidflux": {
"type": "http",
"url": "https://vidflux.ai/api/mcp",
"headers": { "Authorization": "Bearer vf_your_api_key" }
}
}
}Windsurf
أضف ما يلي إلى ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"vidflux": {
"serverUrl": "https://vidflux.ai/api/mcp",
"headers": { "Authorization": "Bearer vf_your_api_key" }
}
}
}Cline وRoo Code وتطبيقات أخرى
أي تطبيق يدعم خوادم Streamable HTTP مع ترويسات مخصصة يعمل بنفس الرابط والترويسة. والتطبيقات التي تدعم stdio فقط يمكنها استخدام أمر mcp-remote الموضح لـ Claude Desktop.
أدوات MCP
| generate_video | يبدأ توليدًا من نص إلى فيديو أو من صورة إلى فيديو أو بالتحكم في الحركة. الوسائط: model وprompt وaspect_ratio وduration وresolution وimage_urls وخيارات خاصة بكل نموذج مثل generate_audio. يعيد معرّف المهمة والرصيد المخصوم. |
| generate_image | ينشئ أو يعدّل الإطارات الرئيسية وصور المنتجات والصور المصغّرة باستخدام GPT Image أو Nano Banana، مع ما يصل إلى 16 صورة مرجعية. |
| get_task | يعيد الحالة (pending أو processing أو completed أو failed) ورابط video_url أو image_url والخطأ إن وُجد والرصيد المستخدم. |
| list_models | يسرد كل معرّفات النماذج مع معلماتها بصيغة JSON Schema وسعرها الافتراضي، ليختار الوكيل النموذج بنفسه. |
| get_credits | يعيد رصيدك المتبقي. |
توليد الفيديو غير متزامن. هكذا يبدو التسلسل المعتاد للوكيل:
list_models → seedance-2 (9:16, audio)
generate_video {model: "seedance-2", prompt: "...", aspect_ratio: "9:16",
duration: 5, dry_run: true}
→ {"credits_required": 425, "sufficient": true}
generate_video {...same arguments without dry_run}
→ {"id": "3f1c9e0a-...", "status": "processing"}
get_task {task_id: "3f1c9e0a-..."} (every 15 s)
→ {"status": "completed", "video_url": "https://...mp4"}الأسعار: رصيد حسب الاستخدام
- الاتصال بالخادم واستدعاء list_models وget_task وget_credits مجاني.
- يكلّف كل فيديو نفس الرصيد المطلوب في vidflux.ai (انظر الجداول أعلاه). تبدأ الباقات من 500 رصيد مقابل 4.98 دولار، والباقات الأكبر أرخص لكل رصيد، ولا تنتهي صلاحية الرصيد المشترى.
- مع dry_run: true يتم التحقق من الوسائط وإرجاع السعر الدقيق وما إذا كان رصيدك كافيًا دون توليد أي شيء.
- تُسترد المهام الفاشلة أو المرفوضة تلقائيًا.
ماذا يمكنك أن تصنع به
إعلانات سناب شات وتيك توك وريلز إنستغرام
من صورة منتج واحدة، أنشئ في المحادثة نفسها عدة مقاطع عمودية 9:16 باستخدام Seedance 2.0 أو Kling 3.0، وقارن بينها واحتفظ بالأفضل أداءً.
فيديوهات المنتجات لمتاجر نون وأمازون وسلة
اطلب من الوكيل تصوير المنتج بخلفيات جديدة باستخدام Nano Banana Pro، ثم تحويل كل لقطة إلى مقطع قصير متكرر بنسبة 1:1 أو 4:5 لصفحة المنتج.
محتوى حالات وقنوات واتساب
أنشئ عدة نسخ قصيرة لعرض موسمي في رمضان أو الأعياد أو لإطلاق منتج جديد، واختر النسخة التي سترسلها لعملائك.
من القصة المصورة إلى الفيديو
يكتب المساعد قائمة اللقطات، ويولّد إطارًا رئيسيًا لكل لقطة، ثم يعالج كل لقطة بـ Veo 3.1 أو Seedance 2.5 مع الحفاظ على اتساق الشخصية عبر الصور المرجعية.
مقاطع فيديو أثناء البرمجة
في Cursor أو Codex، ولّد مقطع خلفية متكررًا يناسب الصفحة التي تبنيها، ونزّله إلى public/ وحدّث الكود الذي يستخدمه.
VidFlux MCP مقارنة بواجهات المزوّدين وخوادم MCP المستضافة ذاتيًا
| VidFlux MCP | واجهة API لكل مزوّد | خادم MCP مفتوح المصدر مستضاف ذاتيًا | |
|---|---|---|---|
| نماذج الفيديو | Veo وKling وSeedance وHailuo وGemini Omni وGrok Imagine | مزوّد واحد لكل حساب | غالبًا مزوّد واحد لكل خادم |
| الإعداد | لصق رابط ومفتاح فقط | مشروع سحابي وفوترة وSDK لكل مزوّد | تثبيت عملية محلية وتشغيلها وتحديثها |
| الفوترة | رصيد واحد، مع استرداد عند الفشل | فواتير وحصص منفصلة | مفاتيحك الخاصة لكل مزوّد |
| معرفة التكلفة قبل المعالجة | dry_run لكل النماذج | حسب الخدمة | حسب الخدمة |
| الأنسب عندما | تريد نماذج فيديو كثيرة من مساعد ذكاء اصطناعي دون إعداد | تحتاج عقود مؤسسات أو أحدث الميزات التجريبية | يجب أن يبقى كل شيء على بنيتك التحتية |
حل المشكلات
- الخادم متصل لكن أدوات الفيديو لا تظهر
- أعد تشغيل التطبيق أو أعد تحميل خوادم MCP، وتأكد من تفعيل وضع Agent (في Cursor وVS Code). في Claude Code اكتب /mcp لعرض قائمة الأدوات.
- الخطأ 401 Unauthorized أو «Missing or invalid API key»
- يجب أن تكون الترويسة بالضبط Authorization: Bearer vf_…. تأكد من أن المفتاح لم يُلغَ ومن عدم نسخ علامات اقتباس أو مسافات زائدة.
- الخطأ 402 INSUFFICIENT_CREDITS
- رصيدك أقل من السعر الذي أعاده dry_run. اشحن رصيدك أو اختر فيديو أقصر أو بدقة أقل أو نموذجًا أرخص.
- الفيديو يبقى طويلًا في حالة processing
- تكتمل معظم الفيديوهات خلال 1 إلى 5 دقائق، بينما تستغرق فيديوهات Seedance 2.5 الطويلة أو Gemini Omni بدقة 4K وقتًا أطول. واصل الاستعلام عبر get_task، وإذا فشلت المهمة يُعاد الخطأ ويُسترد الرصيد.
- الخطأ spawn npx ENOENT في Claude Desktop
- يحتاج mcp-remote إلى Node.js 18 أو أحدث. ثبّت Node.js أو اكتب المسار الكامل لـ npx في حقل command.
- رفض الصور المرجعية
- يجب أن تحتوي image_urls على روابط HTTPS عامة لملفات JPG أو PNG أو WebP. لا يمكن قراءة المسارات المحلية أو الروابط التي تتطلب تسجيل الدخول.
الأسئلة الشائعة
ما أفضل خادم MCP لتوليد الفيديو بالذكاء الاصطناعي؟
إذا أردت خادمًا واحدًا عن بُعد يغطي أبرز نماذج الفيديو (Veo 3.1 وKling 3.0 وSeedance 2.0 و2.5 وHailuo H3 وGemini Omni) دون تثبيت أي شيء، فإن VidFlux MCP مصمم لذلك: نقطة اتصال واحدة (https://vidflux.ai/api/mcp)، ومفتاح API واحد، وتسعير بالرصيد، ومعرفة التكلفة عبر dry_run قبل كل معالجة. وإذا كنت تستخدم مزوّدًا واحدًا فقط ولديك مفتاحه، فقد يكفيك خادم MCP المفتوح المصدر الخاص به.
هل يوجد خادم MCP واحد يتيح Veo وKling وSeedance معًا؟
نعم. يتيحها VidFlux MCP جميعًا عبر أداة generate_video نفسها. اختر النموذج بالوسيط model مثل veo-3.1-fast أو kling-3 أو seedance-2، أو دع الوكيل يستدعي list_models ويقرر.
كيف أضيف خادم MCP للفيديو إلى Claude Code؟
أنشئ مفتاحًا في vidflux.ai من الإعدادات ← API & MCP، ثم نفّذ: claude mcp add --transport http vidflux https://vidflux.ai/api/mcp --header "Authorization: Bearer مفتاحك". تحقق بالأمر claude mcp list ثم اطلب من Claude فيديو.
هل يمكن لـ Cursor أو Codex توليد الفيديو؟
نعم، عبر MCP. في Cursor أضف رابط الخادم وترويسة Authorization إلى ~/.cursor/mcp.json. وفي Codex CLI نفّذ codex mcp add vidflux --url https://vidflux.ai/api/mcp --bearer-token-env-var VIDFLUX_API_KEY. ويمكن لكليهما توليد الفيديو وتنزيله إلى مشروعك.
هل يمكنني استخدام Google Veo 3.1 من Claude أو Cursor؟
نعم. اختر veo-3.1 أو veo-3.1-fast في generate_video. كلاهما ينشئ مقاطع مدتها 8 ثوانٍ بصوت أصلي من نص أو من صورة أو صورتين، دون مشروع Google Cloud أو مفتاح Gemini API.
كم يكلّف توليد فيديو عبر MCP؟
لا توجد رسوم اشتراك لخادم MCP. يُحتسب كل فيديو بنفس رصيد الموقع، فمثلًا مقطع Veo 3.1 Fast مدته 8 ثوانٍ يكلّف 120 رصيدًا. تبدأ الباقات من 500 رصيد مقابل 4.98 دولار ولا تنتهي صلاحيتها. استخدم dry_run: true لمعرفة السعر الدقيق مسبقًا.
هل يُخصم الرصيد إذا فشل الفيديو؟
لا. إذا فشل المزوّد أو تعذّر بدء المهمة يُسترد الرصيد تلقائيًا.
كم يستغرق الفيديو وكيف أحصل على الملف؟
تكتمل معظم الفيديوهات خلال 1 إلى 5 دقائق. تعيد generate_video معرّف المهمة فورًا، ويستعلم الوكيل عبر get_task حتى تصبح الحالة completed، ثم ينزّل ملف MP4 من video_url.
هل يمكن لـ ChatGPT الاتصال بـ VidFlux MCP؟
ليس بعد. الموصلات المخصصة في ChatGPT وتطبيق Claude.ai على الويب تتطلب تسجيل الدخول عبر OAuth، بينما يستخدم VidFlux MCP حاليًا مفاتيح API. يعمل الآن في Claude Code وClaude Desktop (عبر mcp-remote) وCursor وVS Code وWindsurf وCline وCodex CLI، ويمكن استدعاء REST API من أي سكربت أو GPT Action.
هل وضع مفتاح API في إعدادات MCP آمن؟
المفتاح يسمح فقط بتوليد المحتوى وقراءة مهامك ورصيدك، ولا يمكنه تغيير حسابك أو بيانات الدفع. استخدم متغيرات البيئة، ولا ترفع ملفات إعدادات تحتوي على مفاتيح إلى Git، ويمكنك إلغاء أي مفتاح في أي وقت من الإعدادات.
دع مساعد الذكاء الاصطناعي يصنع الفيديو
أنشئ مفتاح API، والصق كتلة إعداد واحدة، واطلب مقطعًا من وكيلك.
احصل على مفتاح API