Chatbox
Подключение Hubris к Chatbox — десктоп-клиенту для чата с моделями. Весь каталог в одном приложении на Windows, macOS, Linux, Android и iOS.
Chatbox — настольный и мобильный клиент для работы с языковыми моделями: чаты с историей, роли-помощники, работа с файлами и изображениями, генерация картинок. Ставится приложением на Windows, macOS, Linux, Android и iOS; переписка хранится на устройстве.
Hubris подключается как OpenAI-совместимый провайдер: приложение само запрашивает каталог, и модели появляются в выпадающем списке над окном чата. Один ключ — все модели, оплата в рублях с общего баланса.
Требования
Подключение
- Откройте Настройки → Провайдеры моделей (Settings → Model Providers).
- Нажмите кнопку добавления провайдера и в открывшемся окне выберите Добавить своего провайдера (Add Custom Provider).
- В окне Add provider заполните Name —
Hubris(как назовёте, так и будет подписан в списке) и API Mode — OpenAI API Compatible, нажмите Add. - На странице нового провайдера заполните поля:
| Поле | Значение |
|---|---|
| API Host (Хост API) | https://api.hubris.pw/v1 |
| API Path | оставьте пустым — по умолчанию /chat/completions; итоговый адрес виден в строке Preview под полями |
| API Key | ваш ключ из личного кабинета, начинается на sk-gw- |
- В блоке Модели (Models) нажмите Получить (Fetch) — Chatbox обратится к
/v1/modelsи подтянет каталог.
Адрес — именно api.hubris.pw, с api. в начале и /v1 в конце. Домен hubris.pw — это сайт и личный кабинет: запросы к API он не обслуживает, и подключение по нему выглядит как «сервис не отвечает».
Выбор моделей
В каталоге Hubris больше 500 моделей. Если весь список в выпадающем меню мешает, оставьте в провайдере только нужные модели — Chatbox позволяет удалить лишние строки и добавить свои вручную.
ID берите из каталога — они пишутся полностью, вместе с вендором и без даты в конце: anthropic/claude-sonnet-5, а не claude-sonnet-5.
| ID | Когда подходит |
|---|---|
google/gemini-3.7-flash | дешёвые быстрые ответы, ежедневная переписка |
anthropic/claude-sonnet-5 | код, длинные документы, работа с изображениями |
openai/gpt-6-astra | самые сложные задачи, где нужен максимум качества |
moonshotai/kimi-k3 | длинный контекст, разбор больших текстов |
Каталог у нас открыт без ключа, поэтому список можно посмотреть прямо в браузере: api.hubris.pw/v1/models.
Встроенный провайдер «Hubris»
Мы отправили в Chatbox провайдера с отдельной карточкой, знаком в списке и готовым набором моделей — pull request на ревью. Пока его не приняли, работает описанный выше способ через Add Custom Provider: разница только в том, что карточку вы заводите сами. Функционально это одно и то же подключение.
Решение проблем
«Не удалось получить модели» (Failed to fetch models)
- Проверьте адрес:
https://api.hubris.pw/v1— сapi.в начале, с/v1в конце, без косой черты после. - Проверьте ключ: он начинается на
sk-gw-, без пробелов по краям. Целиком ключ виден только при создании; если не сохранили — выпустите новый в разделе «Ключи». - Откройте api.hubris.pw/v1/models в браузере. Открывается — значит, API доступен, и дело в ключе или адресе.
Модель есть в каталоге, но чат отвечает ошибкой про модель
ID должен совпадать с каталожным символ в символ, вместе с вендором перед косой чертой. Короткие имена без вендора и имена с датой на конце мы не принимаем — подстановки «похожей» модели не происходит.
Ошибка про недостаточный баланс
Пополните баланс в кабинете — от 300 ₽, через СБП, банковской картой или по счёту для юридических лиц.
Что дальше
- Каталог моделей — ID для списка моделей Chatbox.
- Управление ключами — отдельный ключ под установку, чтобы расход был виден отдельно.
- Расходы — детализация по запросам и моделям.
- Chat Completions — что именно уходит в Hubris из Chatbox.
Обновлено: