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

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

Что умеет Veo

Veo 3.1 генерирует видео по тексту с фиксированной ценой за ролик. Доступны три версии: Quality, Fast и Lite — они отличаются качеством и ценой. Поддерживаются соотношения сторон 16:9 и 9:16, а через image_urls можно передать исходное изображение для image-to-video.

Эндпоинт API

Запрос отправляется на POST /v1/videos/generations. Пример: {"model": "veo-3.1", "prompt": "городская улица ночью, камера медленно движется", "aspect_ratio": "16:9"}. Авторизация — по API-ключу в заголовке x-api-key. Доступные id моделей: veo-3.1, veo-3.1-fast, veo-3.1-lite.

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

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

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

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

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

Чем Quality отличается от Lite?

Quality даёт максимальное качество, Lite — быстрее и дешевле, Fast — баланс.

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

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

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

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