Cherry Studio

Cherry Studio — настольный клиент для работы с языковыми моделями: чаты с историей, помощники с ролями, базы знаний, серверы MCP, перевод и рисование. Ставится приложением на Windows, macOS и Linux; переписка хранится на устройстве.

Hubris подключается как пользовательский провайдер с конечной точкой OpenAI: приложение само запрашивает каталог, и выбранные модели появляются в списке над окном чата. Один ключ — все модели, оплата в рублях с общего баланса.

Требования

• Cherry Studio 2.0 или новее — в этой ветке мастер создания провайдера переделан, путь ниже сверен с версией 2.0.14
• Аккаунт на hubris.pw и API-ключ

Подключение

1. Откройте Настройки → Провайдеры моделей (Settings → Model Provider).
2. Под списком провайдеров нажмите Добавить провайдера (Add Provider) — откроется окно Добавить пользовательского провайдера (Add Custom Provider).
3. Заполните поля:

Под полем адреса появится подсказка Путь запроса: https://api.hubris.pw/v1/chat/completions (Request path) — по ней видно, что адрес разобран правильно. Поле Сообщения Anthropic заполнять не обязательно: модели Claude работают и через конечную точку OpenAI.

4. Нажмите Добавить (Add). Откроется мастер подключения на шаге Выберите модели (Choose models): Cherry Studio обратится к /v1/models и покажет каталог Hubris, сгруппированный по вендорам, со строкой Поиск моделей… и фильтрами по типу моделей.
5. Отметьте нужные модели — например, найдите поиском openai/gpt-4o-mini — и нажмите Добавить выбранные модели (Add selected models).
6. На шаге Проверить и включить нажмите одноимённую кнопку (Verify and enable): приложение отправит короткий пробный запрос первой выбранной модели и включит провайдера. Когда все три пункта отмечены, нажмите Готово (Done).
7. Откройте раздел Чат на левой панели и выберите модель в переключателе над окном чата — по умолчанию там стоит встроенная модель Cherry Studio. Модели Hubris подписаны так: Openai: GPT-4o mini | Hubris.

Кнопка Пропустить (Skip) на шаге с моделями оставляет провайдера невключённым: на его странице появится подсказка «API-ключ сохранён. Выберите хотя бы одну модель, чтобы завершить настройку.» и кнопка Продолжить добавление моделей (Continue adding models), которая возвращает в мастер.

Про /v1 в конце можно не думать: Cherry Studio добавляет его сам, если в адресе нет версии, — https://api.hubris.pw и https://api.hubris.pw/v1 дают один и тот же путь запроса. Знак # в конце адреса отключает это добавление; для Hubris он не нужен.

Выбор моделей

В каталоге Hubris больше 500 моделей. Отмечайте на шаге Выберите модели только нужные — остальные не попадут в список над чатом. Позже список меняется на странице провайдера: Синхронизировать модели (Sync models) открывает каталог заново, значок + (Добавить модель вручную) — окно Добавить модель для ID, введённого руками, а − рядом с моделью убирает её.

ID берите из каталога — они пишутся полностью, вместе с вендором: anthropic/claude-sonnet-5, а не claude-sonnet-5.

Каталог у нас открыт без ключа, поэтому список можно посмотреть прямо в браузере: api.hubris.pw/v1/models.

Встроенный провайдер «Hubris»

Мы отправили в Cherry Studio карточку Hubris для реестра провайдеров — со значком, адресом https://api.hubris.pw/v1 и ссылками на ключи и каталог — pull request на ревью. После приёма Hubris можно будет выбрать из готового списка провайдеров и ввести только ключ. Пока PR не принят, работает описанный выше способ через Добавить провайдера: разница только в том, что карточку вы заводите сами. Функционально это одно и то же подключение.

Решение проблем

«Не удалось получить модели» на шаге выбора моделей

После этих слов Cherry Studio пишет причину:

• «API-ключ недействителен, проверьте и перенастройте» (API Key is invalid) — Hubris не принял ключ. Каталог открыт только для запросов без ключа: с неверным ключом он тоже отвечает ошибкой. Проверьте, что ключ начинается на sk-gw- и скопирован без пробелов по краям, и исправьте его кнопкой Изменить ключ (Edit key). Целиком ключ виден только при создании; если не сохранили — выпустите новый в разделе «Ключи».
• «Не удаётся подключиться к серверу, проверьте настройки сети или прокси» (Cannot connect to server) — проверьте адрес: https://api.hubris.pw/v1, с api. в начале. Подсказка Путь запроса должна заканчиваться на /v1/chat/completions. Если адрес верный, откройте api.hubris.pw/v1/models в браузере: открывается — значит, API доступен, и стоит нажать Повторить (Retry).

Если Cherry Studio пишет «Провайдер не вернул доступных моделей.», проверьте адрес — по верному адресу каталог Hubris никогда не бывает пустым.

«Не прошло» и «Запрос к модели завершился ошибкой» на шаге проверки

Пробный запрос ушёл, но ответа не получилось; причина написана рядом. Чаще всего это неверный ключ или нулевой баланс. Исправьте ключ кнопкой Изменить ключ и повторите проверку.

Модель есть в списке, но чат отвечает ошибкой про модель

ID должен совпадать с каталожным символ в символ, вместе с вендором перед косой чертой. Короткие имена без вендора мы не принимаем — подстановки «похожей» модели не происходит. Это касается моделей, добавленных вручную: те, что выбраны из подтянутого каталога, уже правильные.

Ошибка про недостаточный баланс

Пополните баланс в кабинете — от 500 ₽, через СБП, банковской картой или по счёту для юридических лиц.

Проверено на Cherry Studio 2.0.14, 16 сентября 2026.

Что дальше

• Каталог моделей — ID для списка моделей Cherry Studio.
• Управление ключами — отдельный ключ под установку, чтобы расход был виден отдельно.
• Расходы — детализация по запросам и моделям.
• Chat Completions — что именно уходит в Hubris из Cherry Studio.

Обновлено: 16 сентября 2026 г.