LobeChat: подключение своего OpenAI-совместимого API

Что такое LobeChat

LobeChat — один из самых популярных open-source чат-интерфейсов для работы с ИИ: маркетплейс готовых ассистентов и плагинов, ветвление диалогов, работа с файлами и базами знаний. Работает в трёх вариантах: десктоп-приложение, облако LobeHub и self-hosted на своём сервере. Кастомные провайдеры поддерживаются во всех трёх — с подключённым LLMost весь каталог моделей доступен из одного интерфейса.

Требования

Windows, macOS или Linux — достаточно десктоп-приложения; для сервера — Docker
Аккаунт LLMost с API-ключом

Установка

Вариант 1 — десктоп-приложение (проще всего). Скачайте установщик со страницы lobehub.com (кнопка Download) или из релизов на GitHub и запустите. Сервер и командная строка не нужны.

Вариант 2 — облако. Зарегистрируйтесь на lobehub.com — кастомные провайдеры доступны и в облачной версии, устанавливать ничего не нужно.

Вариант 3 — Docker (self-hosted). Минимальный запуск одним контейнером, LLMost подключается сразу через переменные окружения:

docker run -d -p 3210:3210 \
  -e OPENAI_API_KEY=llmost_... \
  -e OPENAI_PROXY_URL=https://llmost.ru/api/v1 \
  --name lobe-chat \
  lobehub/lobe-chat

Откройте http://localhost:3210. Другие сценарии развёртывания (база данных, многопользовательский режим) — в официальной документации.

Подключение LLMost

Инструкция для десктоп-приложения и облака (в Docker-варианте выше LLMost уже подключён через переменные окружения):

Создайте ключ на странице Ключи API (формат llmost_...).
Откройте Настройки → раздел провайдеров ИИ (AI Provider).
Внизу списка провайдеров нажмите Добавить кастомного провайдера (Add Custom Provider) и заполните:
- Идентификатор: llmost
- Название: LLMost
- Формат запросов (SDK type): OpenAI
- Proxy URL:
```
https://llmost.ru/api/v1
```
- API Key: ваш ключ llmost_...
Нажмите Проверить (Check) — LobeChat сделает тестовый запрос и покажет, что соединение работает.
В списке моделей провайдера нажмите Получить список моделей (Fetch models) — каталог LLMost подтянется автоматически, останется включить нужные модели тумблерами.

Альтернативный путь — не создавать отдельного провайдера, а указать URL и ключ LLMost в настройках встроенного провайдера OpenAI (поле API Proxy URL). Результат тот же, но отдельный провайдер аккуратнее: настройки OpenAI остаются свободными.

Выбор модели

Для повседневной работы достаточно двух-трёх моделей:

~openai/gpt-latest — универсальная флагманская модель, «как ChatGPT»;
~google/gemini-flash-latest — быстрая и дешёвая для повседневных вопросов;
~anthropic/claude-sonnet-latest — сложные задачи, код и длинные документы.

Алиасы, начинающиеся с ~, всегда указывают на актуальную версию модели. Полный список с ценами — в каталоге моделей LLMost.

Проверка

Создайте новый чат, выберите модель LLMost в селекторе и отправьте сообщение. Если пришёл ответ — соединение работает.

Чтобы проверить подключение в обход LobeChat, выполните запрос напрямую:

curl https://llmost.ru/api/v1/chat/completions \
  -H "Authorization: Bearer llmost_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "~google/gemini-flash-latest",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Частые проблемы

Модель отвечает пустым сообщением. Почти всегда — неправильный Proxy URL. Он должен быть ровно https://llmost.ru/api/v1, включая суффикс /v1: URL передаётся в SDK как есть, LobeChat ничего не дописывает. Этому посвящён отдельный FAQ в документации LobeChat.

Проверка соединения не проходит (401). Ключ скопирован не полностью или удалён. Создайте новый на странице Ключи API.

Модели видны, но ответа нет (402). Закончился баланс LLMost — пополните его в личном кабинете.

Список моделей не подтянулся. Нажмите Получить список моделей ещё раз и проверьте Proxy URL — список загружается запросом к https://llmost.ru/api/v1/models с вашим ключом. Модели также можно добавить вручную кнопкой добавления модели, указав ID из каталога LLMost.

Ссылки

Официальный сайт: lobehub.com
Документация: lobehub.com/docs
GitHub: lobehub/lobe-chat
Другие приложения — в каталоге ИИ-агентов

LobeChat + LLMost: настройка провайдера