hubris

LobeHub

Подключение Hubris к LobeHub (бывший LobeChat) — интерфейсу для чата и агентов. Один ключ открывает весь каталог в выпадающем списке моделей.

LobeHub (до 2026 года — LobeChat) — интерфейс для работы с языковыми моделями: чаты с ветвлением, агенты и их расписания, плагины, база знаний, распознавание изображений и генерация картинок. Работает как облачный сервис LobeHub Cloud и как своя установка на сервере; настольное приложение подключается к одному из них.

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

Требования

  • LobeHub — аккаунт LobeHub Cloud или своя установка. Настольное приложение без одного из них не работает: при первом запуске оно предлагает только Войти в LobeHub Cloud или Подключитесь к собственной инстанции сервера LobeHub
  • Аккаунт на hubris.pw и API-ключ

Подключение

  1. Откройте Настройки → Поставщик ИИ (Settings → Provider) и выберите в списке OpenAI.
  2. Заполните поля:
ПолеЗначение
API Keyваш ключ из личного кабинета, начинается на sk-gw-
URL прокси API (API Proxy URL)https://api.hubris.pw/v1
  1. Нажмите Загрузить модели (Fetch models) — LobeHub обратится к /v1/models и подтянет каталог.
  2. В блоке Проверка подключения (Connectivity Check) нажмите Проверить (Check) — интерфейс отправит короткий тестовый запрос и покажет «Проверка пройдена», если всё в порядке.

Адрес — именно api.hubris.pw, с api. в начале и /v1 в конце. Домен hubris.pw — это сайт и личный кабинет: запросы к API он не обслуживает и на любой такой запрос отвечает ошибкой с подсказкой правильного адреса.

Для части моделей и при включённом веб-поиске LobeHub отправляет запросы не в /v1/chat/completions, а в /v1/responses. Hubris принимает оба формата, отдельно настраивать ничего не нужно.

Своя установка: переменные окружения

Если LobeHub стоит на вашем сервере, провайдера можно задать сразу — тогда ключ не придётся вводить каждому пользователю. Добавьте в файл переменных окружения контейнера lobehub/lobehub (тот, что вы передаёте через --env-file или в docker-compose.yml) три строки:

OPENAI_API_KEY=sk-gw-ваш-ключ
OPENAI_PROXY_URL=https://api.hubris.pw/v1
OPENAI_MODEL_LIST=-all,+anthropic/claude-sonnet-5,+openai/gpt-6-astra,+google/gemini-3.8-flash
  • OPENAI_PROXY_URL подменяет адрес OpenAI на наш.
  • OPENAI_MODEL_LIST держит список коротким: -all убирает всё, +id добавляет нужное, id=Название переименовывает пункт меню.

Остальные переменные — база данных, KEY_VAULTS_SECRET, AUTH_SECRET, хранилище файлов — нужны самой установке LobeHub независимо от Hubris; их список и пример запуска — в инструкции LobeHub по Docker.

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

В каталоге Hubris больше 500 моделей, и без фильтра LobeHub выведет в переключатель их все. Список правится в настройках провайдера или переменной OPENAI_MODEL_LIST.

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

IDКогда подходит
google/gemini-3.7-flashдешёвые быстрые ответы, ежедневная переписка
anthropic/claude-sonnet-5код, длинные документы, работа с изображениями
openai/gpt-6-astraсамые сложные задачи, где нужен максимум качества
deepseek/deepseek-v4-proнедорогое рассуждение и код

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

Мы отправили в LobeHub провайдера с отдельной карточкой, собственным списком моделей и живым обновлением каталога — pull request на ревью. Пока его не приняли, работает описанный выше способ через OpenAI-совместимый провайдер: разница только в том, что название в меню будет «OpenAI», а не «Hubris». Функционально это одно и то же подключение.

Если хочется видеть в меню именно «Hubris», в списке поставщиков можно создать своего провайдера: Provider Name — Hubris, Proxy URL — https://api.hubris.pw/v1, API Key — ваш ключ. Дальше те же Загрузить модели и Проверить.

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

Список моделей пустой или «Ошибка подключения»

  • Проверьте адрес: https://api.hubris.pw/v1 — с api. в начале, с /v1 в конце, без косой черты после.
  • Проверьте ключ: он начинается на sk-gw-, без пробелов по краям. Каталог открыт только для запросов без ключа — с неверным ключом Hubris отвечает ошибкой и на запрос списка моделей. Целиком ключ виден только при создании; если не сохранили — выпустите новый в разделе «Ключи».
  • Откройте api.hubris.pw/v1/models в браузере. Если он открывается, а LobeHub список не тянет — дело в ключе или в адресе, а не в доступности API.

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

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

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

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

Что дальше

Обновлено: