Cherry Studio
Подключение Hubris к Cherry Studio — настольному клиенту для чата с моделями. Весь каталог в одном приложении на Windows, macOS и Linux.
Cherry Studio — настольный клиент для работы с языковыми моделями: чаты с историей, помощники с ролями, базы знаний, серверы MCP, перевод и рисование. Ставится приложением на Windows, macOS и Linux; переписка хранится на устройстве.
Hubris подключается как пользовательский провайдер с конечной точкой OpenAI: приложение само запрашивает каталог, и модели появляются в списке над окном чата. Один ключ — все модели, оплата в рублях с общего баланса.
Требования
- Cherry Studio 2.0 или новее — в этой ветке мастер создания провайдера переделан, путь ниже описан для неё
- Аккаунт на hubris.pw и API-ключ
Подключение
- Откройте Настройки → Провайдеры моделей (Settings → Model Provider).
- Нажмите Добавить провайдера (Add Provider) — откроется панель Добавить пользовательского провайдера (Add Custom Provider).
- Заполните поля:
| Поле | Значение |
|---|---|
| Имя провайдера (Provider Name) | Hubris — как назовёте, так и будет подписан в списке |
| Ключ API (API Key) | ваш ключ из личного кабинета, начинается на sk-gw- |
| Настройки конечной точки → OpenAI (Endpoint settings → OpenAI) | https://api.hubris.pw/v1 |
Под полем адреса появится подсказка Путь запроса: https://api.hubris.pw/v1/chat/completions — по ней видно, что адрес разобран правильно. Поле Сообщения Anthropic заполнять не обязательно: модели Claude работают и через конечную точку OpenAI.
- Нажмите Добавить (Add). Откроется мастер подключения на шаге Выберите модели (Choose models): Cherry Studio обратится к
/v1/modelsи покажет каталог Hubris. - Отметьте нужные модели и нажмите Проверить и включить (Verify and enable) — приложение отправит короткий пробный запрос выбранной модели и включит провайдера. Готово — провайдер появится в списке, а модели — в выборе над окном чата.
Кнопка Пропустить на шаге с моделями оставляет провайдера выключенным; вернуться к списку можно позже через Управление моделями (Model management) на странице провайдера.
Адрес — именно api.hubris.pw, с api. в начале. Домен hubris.pw — это сайт и личный кабинет: запросы к API он не обслуживает, и подключение по нему заканчивается ошибкой получения моделей.
Про /v1 в конце можно не думать: Cherry Studio добавляет его сам, если в адресе нет версии, — https://api.hubris.pw и https://api.hubris.pw/v1 дают один и тот же путь запроса. Знак # в конце адреса отключает это добавление; для Hubris он не нужен.
Выбор моделей
В каталоге Hubris больше 500 моделей. Отмечайте на шаге Выберите модели только нужные — остальные не попадут в список над чатом. Добавить или убрать модель позже можно в Управлении моделями; там же кнопка Добавить модель для ID, введённого вручную.
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»
Мы отправили в Cherry Studio карточку Hubris для реестра провайдеров — со значком, адресом https://api.hubris.pw/v1 и ссылками на ключи и каталог — pull request на ревью. После приёма Hubris можно будет выбрать из готового списка провайдеров и ввести только ключ. Пока PR не принят, работает описанный выше способ через Добавить провайдера: разница только в том, что карточку вы заводите сами. Функционально это одно и то же подключение.
Решение проблем
«Провайдер не вернул доступных моделей» или «Не удалось получить модели»
- Проверьте адрес:
https://api.hubris.pw/v1— сapi.в начале, без косой черты послеv1. Подсказка Путь запроса под полем должна заканчиваться на/v1/chat/completions. - Проверьте ключ: он начинается на
sk-gw-, без пробелов по краям. Целиком ключ виден только при создании; если не сохранили — выпустите новый в разделе «Ключи». - Откройте api.hubris.pw/v1/models в браузере. Открывается — значит, API доступен, и дело в ключе или адресе.
«Запрос к модели завершился ошибкой» на шаге проверки
Пробный запрос ушёл, но Hubris его отклонил. Чаще всего это неверный ключ (ответ 401, «Неверный API-ключ») или нулевой баланс. Исправьте ключ кнопкой Изменить ключ и повторите проверку.
Модель есть в списке, но чат отвечает ошибкой про модель
ID должен совпадать с каталожным символ в символ, вместе с вендором перед косой чертой. Короткие имена без вендора и имена с датой на конце мы не принимаем — подстановки «похожей» модели не происходит. Это касается моделей, добавленных вручную: те, что выбраны из подтянутого каталога, уже правильные.
Ошибка про недостаточный баланс
Пополните баланс в кабинете — от 300 ₽, через СБП, банковской картой или по счёту для юридических лиц.
Что дальше
- Каталог моделей — ID для списка моделей Cherry Studio.
- Управление ключами — отдельный ключ под установку, чтобы расход был виден отдельно.
- Расходы — детализация по запросам и моделям.
- Chat Completions — что именно уходит в Hubris из Cherry Studio.
Обновлено:
Chatbox
Подключение Hubris к Chatbox — десктоп-клиенту для чата с моделями. Весь каталог в одном приложении на Windows, macOS, Linux, Android и iOS.
LibreChat
Подключение Hubris к LibreChat — self-hosted чату на несколько пользователей. Отдельная точка подключения в librechat.yaml, каталог подтягивается сам.