Перейти до основного вмісту

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, який дозволяє AI-моделям (наприклад, Claude, GPT тощо) викликати зовнішні інструменти через стандартизований інтерфейс. За допомогою Seedance MCP Server від XHuoAPI ви можете безпосередньо використовувати Seedance від ByteDance для генерації AI-відео у клієнтах AI, таких як Claude Desktop, VS Code, Cursor тощо.

​
Огляд функцій

Seedance MCP Server надає такі основні функції:
  • Генерація відео з тексту — створення високоякісних відео за текстовими підказками
  • Генерація відео з зображень — створення відео з використанням зображень як референсів (перший кадр, останній кадр, режим референсного зображення тощо)
  • Підтримка кількох моделей — підтримка моделей 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 секунд
  • Генерація аудіо — деякі моделі підтримують одночасну генерацію аудіо
  • Моніторинг завдань — відстеження прогресу генерації та отримання результатів

​
Попередні вимоги

Перед використанням необхідно отримати XHuoAPI API Token:
  1. Зареєструйтесь або увійдіть на XHuoAPI платформу
  2. Перейдіть на сторінку Seedance Videos API
  3. Натисніть «Acquire», щоб отримати API Token (при першому запиті надається безкоштовний ліміт)

​
Встановлення та налаштування

​
Спосіб 1: Встановлення через pip (рекомендовано)

pip install mcp-seedance

​
Спосіб 2: Встановлення з вихідного коду

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 Token"
      }
    }
  }
}
Якщо використовуєте uvx (без необхідності попередньої установки пакетів): 
{
  "mcpServers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "XHuoAPI_API_TOKEN": "Ваш API Token"
      }
    }
  }
}
Збережіть конфігурацію та перезапустіть Claude Desktop, після чого можна використовувати інструменти Seedance у діалогах.

​
Використання у VS Code / Cursor

Створіть у корені проекту файл .vscode/mcp.json: 
{
  "servers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "XHuoAPI_API_TOKEN": "Ваш API Token"
      }
    }
  }
}
Або з uvx: 
{
  "servers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "XHuoAPI_API_TOKEN": "Ваш API Token"
      }
    }
  }
}

​
Список доступних інструментів

Назва інструментуОпис
seedance_generate_videoГенерація відео за текстовими підказками
seedance_generate_video_from_imageГенерація відео з використанням зображення
seedance_get_taskПеревірка статусу одного завдання
seedance_get_tasks_batchМасова перевірка статусу завдань
seedance_list_modelsПерелік усіх доступних моделей та їх можливостей
seedance_list_resolutionsПерелік доступних роздільних здатностей і співвідношень сторін
seedance_list_actionsПерелік усіх доступних інструментів та прикладів робочих процесів

​
Приклади використання

Після налаштування ви можете безпосередньо викликати ці функції природною мовою у AI-клієнтах, наприклад:
  • «Зроби, будь ласка, таймлапс відео міських вулиць за допомогою Seedance»
  • «Зроби 8-секундне відео, використовуючи цю фотографію як перший кадр»
  • «Згенеруй коротке відео 1080p у вертикальному форматі 9:16»
  • «Згенеруй відео з аудіо за допомогою моделі Seedance 1.5 Pro»

​
Додаткова інформація