Один запрос на все модели
Любая генерация — это 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 не даёт повторной отправке создать вторую генерацию.
IDEMPOTENCY_KEY="${IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.givon.ai/api/v1/generations \
-H "Authorization: Bearer $GIVON_API_KEY" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"image","model":"chatgpt-images-2","input":{"prompt":"кот в очках читает книгу"}}'Свои файлы, голоса, аватары и кабинет
Голоса и аватары открыты на чтение: id голоса передаётся в озвучку, снимки аватара — как референсы изображения или видео.
| Путь | Что делает |
|---|---|
| POST /api/v1/assets | Загружает свой файл, возвращает asset:// URI для полей-референсов модели. |
| POST /api/v1/assets/import | Импортирует по ссылке HTTPS или data URI, возвращает asset:// URI. |
| GET /api/v1/voices | Перечисляет обученные голоса аккаунта вместе с базовыми. |
| GET /api/v1/avatars | Перечисляет аватаров Студии с готовыми ракурсами. |
Инструкции, ключи и справка по моделям собраны в кабинете, раздел «Интеграции»: вкладки «Агент», «Чат», «CLI», «Навыки» и «API», Playground и примеры на cURL, JavaScript и Python для каждой модели, «Ключи» и «История» запросов. Безлимит изображений тарифа Studio Pro в API и MCP не действует: изображения оплачиваются токенами, процентные скидки тарифа на видеомодели сохраняются.
llms.txt, llms-full.txt и openapi.json на givon.ai открыты без входа, страницы моделей копируются для агента через меню «Для ИИ».
MCP и CLI без ключа
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. Навыки собраны в группы «Генерация», «Промпты», «Монтаж и звук», «Маркетплейсы», «Тексты и маркетинг» и «Истории»; перед каждым запуском агент называет цену в токенах и ждёт твоего подтверждения.
Где это используют
Контент в своём продукте
Сервис, CRM или каталог вызывает POST /api/v1/generations и забирает результат по id генерации.
Задача AI-агенту в терминале
Codex или Claude Code с навыками Givon собирает карточки маркетплейса, ролик с озвучкой и музыкой или серию кадров с одним героем.
Генерация из веб-чата
В claude.ai или ChatGPT с коннектором Givon видео, обложка или озвучка запускаются из обычного диалога.
Серия с одним голосом и аватаром
Скрипт передаёт один и тот же id голоса из GET /api/v1/voices и снимки аватара из его ассетов в каждую генерацию серии.
