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

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

Что умеет Gemini Omni

Gemini Omni генерирует видео по тексту и поддерживает до нескольких референсов, чтобы сохранить внешность персонажа. Версия 1.1 Flash принимает разрешения 360p, 720p, 1080p и 4K, а Omni 1 — 720p, 1080p и 4K. Длительность выбирается из 4, 6, 8 или 10 секунд.

Эндпоинт API

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

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

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

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

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

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

Сколько референсов можно передать?

Несколько изображений, чтобы сохранить внешность персонажа.

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

1.1 Flash — 360p, 720p, 1080p и 4K; Omni 1 — 720p, 1080p и 4K.

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

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