HovAi API

Документация API

OpenAI-совместимый интерфейс для текстовых моделей HovAi.

Адрес и авторизация

Base URL: https://hovai.ru/v1
Authorization: Bearer hvk_…

Полный ключ показывается один раз при создании. Храните его только в секретах сервера, не помещайте в браузерный JavaScript или публичный репозиторий.

Список моделей

curl https://hovai.ru/v1/models -H "Authorization: Bearer $HOVAI_API_KEY"

Создание ответа

curl https://hovai.ru/v1/chat/completions \
  -H "Authorization: Bearer $HOVAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/gpt-5.4-mini","messages":[{"role":"user","content":"Привет"}]}'

Поддерживаются роли system, user и assistant. Для потокового ответа передайте "stream": true; данные возвращаются в формате SSE и завершаются событием [DONE].

Баланс и ограничения

Ограниченный доступ к видео

В профиле можно отдельно выдать видеоключ. Владелец аккаунта подтверждает списания, выбирает модель и задаёт предел за один ролик и за календарный месяц UTC. Такой ключ привязан к одному чату, не запускает текстовые модели и отключается в списке ключей. В этом чате владелец может загрузить изображения-референсы, например свою картину.

POST https://hovai.ru/api/sessions/{session_id}/generate
Authorization: Bearer hvk_…
Content-Type: application/json

{"prompt":"Короткое описание движения камеры и сцены",
 "idempotency_key":"уникальный ключ запроса",
 "media":{"duration":5,"aspect_ratio":"9:16"}}

Ответ 202 содержит идентификатор генерации. Проверяйте состояние через GET https://hovai.ru/api/generations/{generation_id} с тем же ключом. Ссылки на готовое видео доступны только в привязанном чате. Повтор запроса с тем же ключом идемпотентен; лимит и доступный баланс проверяются до резерва.

Коды ответов