Seedance API и MCP: как подключить генерацию видео к своему проекту

Seedance — модель генерации видео. На NeuralSpace доступны модели: Seedance 2.0. Все они работают через единый публичный API, а для ИИ-агентов есть готовый MCP-сервер. Ключ выдаётся на странице API-ключей. Ниже — возможности модели, примеры запросов и способ настройки.

Что умеет Seedance

Seedance 2.0 генерирует видео по текстовому описанию. Генерация асинхронная: POST создаёт задачу и возвращает id, затем статус опрашивается через GET /v1/videos/generations/:id до готовности. Доступны скорость fast или standard и разрешения 720p и 1080p, цена посекундная.

Эндпоинт API

Запрос отправляется на POST /v1/videos/generations. Пример: {"model": "seedance-2.0", "prompt": "крупный план товара на тёмном столе", "duration": 5, "resolution": "720p"}. Авторизация — по API-ключу в заголовке x-api-key. Доступные id моделей: seedance-2.0.

MCP-инструменты

MCP-сервер NeuralSpace доступен по адресу POST /mcp (Streamable HTTP). Для работы с Seedance агент использует инструменты: generate_video, check_video, list_models, get_balance. Это позволяет Claude Code, Cursor и другим MCP-клиентам пользоваться моделями сайта напрямую.

Как подключить

Зарегистрируйтесь на NeuralSpace, откройте API-ключей и создайте ключ формата nsk-…. Дальше передавайте его в заголовке запроса или в настройках MCP-клиента. Полная документация — на странице /v1/docs.

Частые вопросы

Генерация синхронная или асинхронная?

Асинхронная: POST создаёт задачу, статус опрашивается через GET /v1/videos/generations/:id.

Какие разрешения доступны?

720p и 1080p, скорость fast или standard.

Какой формат у запроса?

POST /v1/videos/generations с полями model, prompt, duration и resolution.