الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

MCP (Model Context Protocol) هو بروتوكول سياق النموذج الذي أطلقته Anthropic، يسمح لنماذج الذكاء الاصطناعي مثل Claude و GPT وغيرها باستدعاء أدوات خارجية عبر واجهة موحدة. من خلال خادم Seedance MCP المقدم من XHuoAPI، يمكنك استخدام فيديوهات الذكاء الاصطناعي التي تنتجها ByteDance Seedance مباشرة في عملاء الذكاء الاصطناعي مثل Claude Desktop و VS Code و Cursor.

​
نظرة عامة على الوظائف

يقدم خادم Seedance MCP الوظائف الأساسية التالية:
  • توليد الفيديو من النص — إنشاء فيديو عالي الجودة بناءً على نصوص وصفية
  • توليد الفيديو من الصور — إنشاء فيديو باستخدام صورة كمرجع (إطارات أولى، أخيرة، أو نماذج مرجعية)
  • دعم نماذج متعددة — يدعم نماذج Seedance 1.5 Pro، 1.0 Pro، 1.0 Lite وغيرها
  • دقة متعددة — يدعم دقة 480p، 720p، 1080p وغيرها
  • نسب أبعاد متعددة — يدعم نسب 16:9، 9:16، 1:1، 4:3، 3:4، 21:9 وغيرها
  • مدة مرنة — يدعم مدة فيديو من 2 إلى 12 ثانية
  • توليد الصوت — بعض النماذج تدعم توليد الصوت مع الفيديو
  • استعلام المهام — مراقبة تقدم التوليد والحصول على النتائج

​
المتطلبات المسبقة

قبل الاستخدام، تحتاج إلى الحصول على رمز API من XHuoAPI:
  1. قم بالتسجيل أو تسجيل الدخول إلى منصة XHuoAPI
  2. انتقل إلى صفحة Seedance Videos API
  3. اضغط على “Acquire” للحصول على رمز API (تحصل على حصة مجانية عند الطلب الأول)

​
التثبيت والإعداد

​
الطريقة الأولى: التثبيت عبر pip (موصى به)

pip install mcp-seedance

​
الطريقة الثانية: التثبيت من المصدر

git clone https://github.com/XHuoAPI/SeedanceMCP.git
cd SeedanceMCP
pip install -e .
بعد التثبيت، يمكنك بدء الخدمة باستخدام الأمر mcp-seedance.

​
الاستخدام في Claude Desktop

قم بتحرير ملف إعدادات Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
أضف الإعداد التالي: 
{
  "mcpServers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "XHuoAPI_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}
إذا كنت تستخدم uvx (لا حاجة لتثبيت الحزم مسبقًا): 
{
  "mcpServers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "XHuoAPI_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}
بعد حفظ الإعدادات، أعد تشغيل Claude Desktop لتتمكن من استخدام أدوات Seedance في المحادثات.

​
الاستخدام في VS Code / Cursor

أنشئ ملف .vscode/mcp.json في جذر المشروع: 
{
  "servers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "XHuoAPI_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}
أو استخدم uvx: 
{
  "servers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "XHuoAPI_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}

​
قائمة الأدوات المتاحة

اسم الأداةالوصف
seedance_generate_videoتوليد فيديو من نصوص وصفية
seedance_generate_video_from_imageتوليد فيديو باستخدام صورة كمرجع
seedance_get_taskاستعلام حالة مهمة واحدة
seedance_get_tasks_batchاستعلام حالة مهام متعددة
seedance_list_modelsعرض جميع النماذج المتاحة وقدراتها
seedance_list_resolutionsعرض الدقات ونسب الأبعاد المتاحة
seedance_list_actionsعرض جميع الأدوات وأمثلة سير العمل

​
أمثلة على الاستخدام

بعد الإعداد، يمكنك استدعاء هذه الوظائف مباشرة باستخدام اللغة الطبيعية في عملاء الذكاء الاصطناعي، مثل:
  • “ساعدني في توليد فيديو تصوير تسريع لشارع في المدينة باستخدام Seedance”
  • “استخدم هذه الصورة كإطار أول، واصنع فيديو مدته 8 ثوانٍ”
  • “أنشئ فيديو قصير بدقة 1080p ونسبة عرض إلى ارتفاع 9:16”
  • “استخدم نموذج Seedance 1.5 Pro لتوليد فيديو مع صوت”

​
مزيد من المعلومات