Документация 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].
Баланс и ограничения
- API расходует денежный баланс HovAi, но не бонусные средства.
- Ключ работает только с моделями, выбранными при создании.
- Расходы появляются в общей истории операций.
- При ошибке генерации резерв освобождается автоматически.
Ограниченный доступ к видео
В профиле можно отдельно выдать видеоключ. Владелец аккаунта подтверждает списания, выбирает модель и задаёт предел за один ролик и за календарный месяц 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} с тем же ключом. Ссылки на готовое видео доступны только в привязанном чате. Повтор запроса с тем же ключом идемпотентен; лимит и доступный баланс проверяются до резерва.
Коды ответов
401— ключ недействителен или отключён.402— недостаточно денежного баланса.403— модель не разрешена для ключа.429— превышен лимит запросов.