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

Seedance 2.5 доступна на NeuralSpace не только в веб-интерфейсе, но и через публичный API /v1 и сервер протокола MCP. Разработчики и ИИ-агенты могут напрямую генерировать видео в коде: отправлять текстовые промпты, передавать референсные изображения и видео, управлять длительностью и забирать готовый результат по ссылке.

Как устроен API

Видео генерируется минутами, поэтому API асинхронный. Сначала вы отправляете POST-запрос на создание задачи — сервис сразу рассчитывает стоимость, списывает токены и возвращает идентификатор задачи. Затем опрашиваете статус, и когда ролик готов, получаете прямую ссылку на видео. При ошибке или таймауте токены возвращаются автоматически. API-ключи выпускаются в личном кабинете в разделе API-ключи.

Эндпоинты API

Создание задачи — POST /v1/videos/generations с телом { model: "seedance-2.5", prompt, duration, resolution, aspect_ratio, image_urls, video_urls, audio_urls }. Проверка статуса и результат — GET /v1/videos/generations/:id. Актуальный список моделей и тарифов доступен на странице документации API и через GET /v1/models.

Подключение через MCP (Model Context Protocol)

Для Claude Desktop, Cursor, Cline и других ИИ-агентов на платформе развёрнут официальный MCP-сервер по адресу https://neuralspace.pro/mcp. Модель Seedance 2.5 доступна в инструменте generate_video с опросом через check_video. ИИ-агент может самостоятельно формулировать промпт, задавать параметры и прикладывать референсы.

{
  "mcpServers": {
    "neuralspace": {
      "url": "https://neuralspace.pro/mcp",
      "headers": {
        "x-api-key": "nsk-ваш_ключ"
      }
    }
  }
}

Возможности Seedance 2.5

В публичном API и MCP модель Seedance 2.5 представлена идентификатором seedance-2.5. Поддерживаются разрешения 480p, 720p и 1080p, длительность от 4 до 30 секунд, генерация аудио, соотношения сторон 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 или adaptive, а также референсные изображения и видео. Визуально опробовать все параметры перед интеграцией можно на странице модели в веб-интерфейсе.

Пример запроса через cURL

Создание задачи генерации через публичный API:

curl https://neuralspace.pro/v1/videos/generations \
  -H "x-api-key: nsk-ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "крупный план футуристического кристалла на темном столе, мягкий неоновый свет, кинематографичное движение",
    "duration": 5,
    "resolution": "720p"
  }'

В ответ возвращается id задачи, статус pending и URL для опроса. Получение статуса:

curl https://neuralspace.pro/v1/videos/generations/TASK_ID \
  -H "x-api-key: nsk-ваш_ключ"

При статусе completed ответ содержит ссылку на готовое видео в поле data[0].url.

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

Seedance 2.5 доступна через API и MCP?

Да, Seedance 2.5 полностью доступна и в публичном REST API (идентификатор seedance-2.5), и через официальный MCP-сервер в инструменте generate_video. Полное описание параметров есть в документации API.

Как получить API-ключ?

Ключ выпускается мгновенно в личном кабинете на странице API-ключи.

Сколько стоит генерация через API?

Тариф посекундный, совпадает с тарифом на сайте и зависит от разрешения (480p, 720p или 1080p). Живые цены в токенах возвращаются в GET /v1/models и указаны на /v1/docs.