API, MCP и CLI для AI-агентов

Генерация Givon AI доступна вне интерфейса по трём путям: REST API для своих сервисов, MCP-сервер для AI-агентов и веб-чатов, CLI givon для терминала. Все три работают с изображениями, видео, музыкой и озвучкой и списывают токены того же баланса.

Любая генерация — это POST /api/v1/generations с телом { type, model, input }, где type — image, video, music или voiceover. GET /api/v1/models перечисляет модели с ценами, GET /api/v1/models/{id} отдаёт JSON-схему входа: допустимые поля, лимиты и стоимость вариантов. Генерация идёт в фоне: ответ возвращает id, по нему забираются статус и результат.

Цена известна до запуска. POST /api/v1/generations/quote принимает то же тело и ничего не списывает. Поле maxTokens ставит потолок: если цена выросла выше него, генерация не стартует и токены не списываются. Заголовок Idempotency-Key не даёт повторной отправке создать вторую генерацию.

Свои файлы загружаются через POST /api/v1/assets, ссылки HTTPS и data URI импортируются через /assets/import; оба возвращают asset:// URI для полей-референсов модели. GET /api/v1/voices перечисляет обученные голоса аккаунта вместе с базовыми, GET /api/v1/avatars — аватаров Студии с готовыми ракурсами. Голоса и аватары открыты на чтение: id голоса передаётся в озвучку, снимки аватара — как референсы изображения или видео.

MCP-сервер https://api.givon.ai/mcp даёт AI-агенту те же действия: найти модель, прочитать её схему, узнать цену, запустить генерацию, проверить статус, загрузить файл, перечислить голоса и аватаров, узнать баланс. Ключ для подключения не нужен: при первом обращении открывается браузер, ты входишь в Givon и нажимаешь «Разрешить и подключить». В claude.ai, Claude Desktop и ChatGPT Givon добавляется как коннектор по тому же адресу.

Команда curl -fsSL https://givon.ai/install.sh | sh ставит CLI givon, при необходимости приносит свой Python, открывает вход в браузере и устанавливает навыки Givon для Codex и Claude Code. Навыки собраны в группы «Генерация», «Промпты», «Монтаж и звук», «Маркетплейсы», «Тексты и маркетинг» и «Истории»; перед каждым запуском агент называет цену в токенах и ждёт твоего подтверждения.

Инструкции, ключи и справка по моделям собраны в кабинете, раздел «Интеграции»: вкладки «Агент», «Чат», «CLI», «Навыки» и «API», Playground и примеры на cURL, JavaScript и Python для каждой модели, «Ключи» и «История» запросов. Безлимит изображений тарифа Studio Pro в API и MCP не действует: изображения оплачиваются токенами, процентные скидки тарифа на видеомодели сохраняются.