12 июня 2026 г.
API и MCP: генерация Givon AI в твоих сервисах и AI-агентах
Теперь генерацию видео и изображений Givon AI можно вызывать из кода и из AI-агентов — без работы через интерфейс. REST API с каталогом моделей, который описывает себя сам, и MCP-сервер для агентов: один способ вызова для всех моделей.
Теперь генерацию Givon AI можно встроить в свои сервисы и AI-агентов — без работы через интерфейс. Появились REST API, MCP-сервер и owner-media ассеты для референсов.
Главная идея API — один способ вызова для всех моделей. Запрашиваешь каталог моделей, видишь поля, ограничения и стоимость каждой, копируешь пример и отправляешь генерацию. Меняется только поле input — и оно всегда описывает себя само.
MCP-сервер даёт то же самое твоему AI-агенту: агент сам читает схему нужной модели и собирает корректный запрос, а ты не зашиваешь параметры руками. Подключается одним блоком конфигурации с твоим ключом.
Запросы тратят токены твоего баланса — столько же, сколько та же генерация в интерфейсе. Ключи выпускаются в личном кабинете, в разделе «Интеграции».
На странице
Что изменилось
Каталог моделей
GET /api/v1/models — список моделей с назначением, полями, лимитами и стоимостью. Discovery вместо угадывания.
Один запрос на все модели
POST /api/v1/generations с телом { type, model, input }. Минимальный input работает для любой модели — остальное берётся из схемы.
Схема каждой модели
GET /api/v1/models/{id} возвращает поля как JSON-Schema: какие значения допустимы, что обязательно и сколько стоит вариант.
Ассеты и референсы
POST /api/v1/assets и /assets/import возвращают asset:// URI, который можно передать в schema-backed поля модели.
Понятные ошибки до списания
Поля проверяются по схеме модели до того, как потрачен хоть один токен; в ответе виден estimatedTokens — оценка стоимости до старта генерации.
MCP для агентов
Агент сам находит модель, читает её схему, запускает генерацию и проверяет статус — теми же действиями, что и через REST.
Как устроено
Discovery → вызов → результат
Внутренний реестр моделей — единственный источник правды. Он проецируется в три поверхности, которые не могут разойтись: REST API, каталог моделей в формате JSON-Schema и MCP. Поэтому поля, лимиты и стоимость в документации всегда совпадают с тем, что реально принимает генерация.
Сценарий простой: GET /models → выбираешь модель → копируешь пример input из её схемы → POST /generations → опрашиваешь статус по id вида gen_… → получаешь готовое медиа. Способ вызова учишь один раз, дальше он одинаков для всех моделей — меняются только модель и поля input.
Документация, плейграунд и ключи — в кабинете
Эндпоинты, схемы моделей, примеры запросов (cURL, JavaScript, Python) и выпуск API-ключей — в разделе «Интеграции» личного кабинета. Там же любую модель можно прогнать в плейграунде. Запросы тратят токены твоего баланса.
Что надо знать
С чего начать
Ключ
Выпусти API-ключ в кабинете: «Интеграции» → «Ключи». Секрет показывается один раз — сохрани сразу. Передавай ключ в заголовке Authorization: Bearer gvk_…
Модели
Через API доступны модели изображений и видео. Полный список с полями и стоимостью — GET /api/v1/models или каталог в кабинете.
Стоимость
Запрос тратит токены твоего баланса — столько же, сколько та же генерация в интерфейсе. Оценка estimatedTokens возвращается до старта.
Асинхронность
Генерация обрабатывается в фоне: создаёшь запрос (POST /generations), получаешь id вида gen_…, опрашиваешь GET /generations/{id} до готовности.
Без дублей
Передай заголовок Idempotency-Key, чтобы повторная отправка того же запроса не создала вторую генерацию.
MCP
Подключение к AI-агенту
MCP (Model Context Protocol) — стандарт, по которому AI-агенты подключают внешние инструменты. Наш MCP-сервер даёт агенту тот же набор действий, что и REST: найти модель, прочитать её схему, запустить генерацию, проверить статус и узнать баланс.
Агент сам узнаёт, какие поля принимает модель, и формирует корректный запрос — параметры не нужно зашивать вручную. Это удобно, когда генерация Givon AI — один из шагов в более крупном агентном сценарии.
Как подключить
Добавь Givon как MCP-сервер в своём агенте: адрес https://api.givon.ai/mcp и заголовок Authorization: Bearer с API-ключом. Готовый блок конфигурации — в кабинете, вкладка «MCP» раздела «Интеграции».
Вопросы
Частые вопросы
- Чем API отличается от работы в интерфейсе?
- Тот же движок генерации, но вызывается из твоего кода или агента. Удобно для автоматизации, пакетной генерации и встраивания в свои продукты.
- Какие модели доступны через API?
- Модели изображений и видео. Полный список с полями, лимитами и стоимостью — GET /api/v1/models или каталог моделей в кабинете.
- Сколько стоят запросы через API?
- Запросы тратят токены твоего баланса — столько же, сколько та же генерация в интерфейсе. В ответе виден estimatedTokens — оценка стоимости до старта генерации.
- Что такое MCP и зачем он мне?
- MCP — стандарт, по которому AI-агенты подключают инструменты. Наш MCP-сервер позволяет агенту самому узнать схему модели и собрать корректный запрос на генерацию, без ручной настройки параметров.
- Как получить ключ?
- В личном кабинете, раздел «Интеграции» → «Ключи». Секрет ключа показывается один раз — сохрани его сразу и храни в надёжном месте.