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

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

Что умеет Sora

Sora 2 генерирует видео по тексту, цена зависит от длительности (10 или 15 секунд). У Sora 2 Pro дополнительно выбирается качество standard или high. Поддерживаются ориентации landscape и portrait, а через image_urls можно передать исходное изображение для image-to-video.

Эндпоинт API

Запрос отправляется на POST /v1/videos/generations. Пример: {"model": "sora-2", "prompt": "волны на берегу на закате", "duration": 10, "aspect_ratio": "landscape"}. Авторизация — по API-ключу в заголовке x-api-key. Доступные id моделей: sora-2, sora-2-pro.

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

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

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

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

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

Какие длительности доступны?

10 и 15 секунд.

Чем Pro отличается от обычной версии?

Pro дополнительно позволяет выбрать качество standard или high.

Поддерживает ли референсы?

Да, image-to-video через image_urls.