Запустите LobeChat на кастомном OpenAI-совместимом эндпоинте.

Updated 2026-07-29

Модуль провайдеров LobeChat принимает любой OpenAI-совместимый сервис: создайте кастомного провайдера с типом SDK OpenAI, укажите эндпоинт https://api.apisrouter.com/v1, вставьте один ключ и получите список моделей. ID Claude, GPT, Gemini и DeepSeek окажутся в пикере моделей каждого ассистента.

Короткий ответ: один кастомный провайдер, один эндпоинт, один ключ.

Откройте настройки LobeChat и перейдите в раздел провайдера AI-сервиса (в зависимости от релиза называется AI Service Provider или Language Model). Поскольку модуль управления провайдерами появился в v1.44, можно создать кастомного провайдера, а не «подстраиваться» под встроенную запись OpenAI: добавьте провайдера, задайте ему ID и отображаемое имя (apisrouter / APIsRouter), выберите тип SDK OpenAI, затем заполните API-ключ и proxy URL эндпоинта значением https://api.apisrouter.com/v1. В списке моделей провайдера используйте действие получения моделей, чтобы подтянуть каждый ID, обслуживаемый эндпоинтом через /v1/models, включите нужные и запустите встроенную проверку связи. С этого момента любой ассистент или разговор сможет выбрать эти ID из пикера моделей. Проект теперь живёт на GitHub как lobehub/lobehub (репозиторий lobe-chat редиректит туда), а подписи меню меняются между релизами, так что относитесь к самому потоку — запись провайдера, тип SDK, URL, ключ, получение списка — как к стабильной части, а не к точной формулировке.

Provider ID:    apisrouter
Provider Name:  APIsRouter
SDK Type:       OpenAI
API Key:        sk-YOUR-APISROUTER-KEY
API Proxy URL:  https://api.apisrouter.com/v1

Model List → Fetch models → enable ids → check

Как LobeChat маршрутизирует запросы к провайдеру.

LobeChat (около 80K звёзд на GitHub, теперь под именем LobeHub) — один из самых развёрнутых open-source чат-фреймворков: отполированный веб-клиент, ассистенты с собственными промптами и моделями, система плагинов и функции базы знаний, разворачиваемый в браузерной сессии или self-hosted с базой данных. Каждая запись провайдера описывает, куда идут запросы и на каком диалекте SDK говорить. Кастомный провайдер с типом SDK OpenAI отправляет стандартные запросы chat-completions на ваш proxy URL с ID модели как простой строкой — именно такую форму и ожидает мультивендорный шлюз. Одна запись, таким образом, несёт весь каталог: ассистенты могут закрепить claude-sonnet-4-6 для внимательной работы, пока быстрые разговоры идут на gemini-3.5-flash, без второго аккаунта где-либо. У URL эндпоинта есть один задокументированный нюанс, который стоит процитировать: нужен ли URL суффикс /v1, зависит от сервиса за ним. LobeChat дописывает пути маршрутов вроде /chat/completions к тому base, который вы дали, так что для APIsRouter правильное значение — https://api.apisrouter.com/v1. Задокументированный симптом отсутствующего суффикса — пустой ответ модели на тесте; если вы это увидите, добавьте /v1 и повторите.

Self-hosting: путь через переменные окружения.

Если вы разворачиваете LobeChat самостоятельно, ту же маршрутизацию можно зашить прямо в контейнер, а не кликать в UI. Классическая пара переопределяет встроенного провайдера OpenAI: OPENAI_API_KEY несёт ключ шлюза, а OPENAI_PROXY_URL — https://api.apisrouter.com/v1. Каждый пользователь этого деплоя тогда наследует эндпоинт, не трогая настройки. Видимость моделей контролируется синтаксисом списка моделей: OPENAI_MODEL_LIST принимает +id для добавления, -id для скрытия и id=Display Name для переименования, через запятую. Начало значения с -all очищает встроенный список, так что показываются только ваши явные ID — чистая форма для курируемого деплоя. Более новые серверные сборки также документируют семейство CUSTOM_PROVIDER_* (count, id, name, type, base URL, keys) для объявления полноценных кастомных провайдеров на этапе деплоя, повторяя то, что делает модуль UI. Проверьте актуальный справочник переменных окружения для своей версии, прежде чем на него полагаться, поскольку эта поверхность новее пары OPENAI_* и всё ещё развивается.

OPENAI_API_KEY=sk-YOUR-APISROUTER-KEY
OPENAI_PROXY_URL=https://api.apisrouter.com/v1
OPENAI_MODEL_LIST=-all,+claude-sonnet-4-6=Claude Sonnet 4.6,+gpt-5.5,+gemini-3.5-flash,+deepseek-v4-pro

Выбор моделей для ассистентов.

Поскольку все ассистенты тарифицируются через один ключ, сравнение моделей — это правка настроек ассистента. Закрепите двух кандидатов на двух дублирующих ассистентах, прогоните свои реальные промпты неделю и прочитайте расходы по модели в консоли APIsRouter рядом с качеством ответов, которое вы наблюдали.

  • Ассистенты — это закреплённые модели по роли. Ассистент для письма на claude-sonnet-4-6, ассистент для быстрых ответов на claude-haiku-4-5-20251001 и исследовательский ассистент на gpt-5.5 прекрасно сосуществуют за одной записью провайдера.
  • gemini-3.5-flash — выбор для отзывчивости в качестве модели разговора по умолчанию; большинство ходов в чат-фреймворке короткие, и быстрые модели держат UI ощущением мгновенности.
  • deepseek-v4-pro заслуживает места для длинных многоязычных разговоров и тяжёлой суммаризации, где её поведение на длинном контексте на потраченный токен — главный аргумент.
  • Разговорам с изображениями нужен ID с поддержкой зрения и включённой возможностью в конфигурации модели провайдера; LobeChat выставляет переключатели возможностей по модели в модуле провайдера.
  • Включайте двухуровневый пикер осознанно — один быстрый ID и один флагманский — и добавляйте другие только когда реальному ассистенту они нужны; каждая включённая модель — это строка, которую пользователи прокручивают.

Оплата по факту · дешевле официальных цен

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

МодельОфициальная ценаНаша цена
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
GPT-5.5$5.00 / $30.00 per M$4.00 / $24.00 per M
Gemini 3.5 Flash$1.50 / $9.00 per M$1.20 / $7.20 per M
DeepSeek V4 Pro$0.43 / $0.87 per M$0.40 / $0.90 per M
Claude Haiku 4.5 20251001$1.00 / $5.00 per M$0.80 / $4.00 per M

Сбои, специфичные именно для LobeChat.

Пустой ответ на проверке связи — задокументированный признак проблемы суффикса base URL. Добавьте или уберите /v1 (для APIsRouter он должен присутствовать) и повторите, прежде чем отлаживать что-либо глубже. Модели, отсутствующие в пикере ассистента, обычно означают, что они были получены, но не включены в списке моделей провайдера, либо сам переключатель провайдера выключен. Оба живут на одном экране настроек, что и действие получения списка. На self-hosted деплоях помните о приоритете: переменные окружения настраивают серверные значения по умолчанию, а пользователи всё ещё могут вводить собственные настройки провайдера на стороне клиента, в зависимости от аутентификации и флагов функций вашего деплоя. Если деплой игнорирует ваш OPENAI_PROXY_URL, подтвердите, что контейнер реально перезапустился с новым окружением и что клиентская сессия не переопределяет его локально. Расхождение версий здесь реально: дерево настроек реорганизовывалось не раз (Language Model, затем AI Service Provider, с модулем провайдера, появившимся в v1.44), и скриншоты из старых туториалов не совпадут с текущими меню. Сами поля — ID, имя, тип SDK, URL, ключ — оставались стабильными.

Кто направляет LobeChat через шлюз.

  • Self-hosters, запускающие LobeChat для команды и желающие один эндпоинт в контейнере и один лог использования на всех, вместо вендорских ключей на пользователя.
  • Активные пользователи ассистентов, закрепляющие разных вендоров по ролям — Claude для письма, GPT для анализа, DeepSeek для объёма — не поддерживая аккаунты для каждого.
  • Пользователи, желающие модели, которых нет во встроенном списке провайдеров, включённые через получение каталога шлюза, а не ожидание вышестоящих релизов.
  • Разработчики без доступа к биллингу конкретного вендора. Доступ на основе пополнения без требования карты убирает зависимость от регистрации у каждого провайдера.
  • Люди, уже направляющие свой редактор, лаунчер или CLI-инструменты через шлюз и желающие видеть свой чат-фреймворк на том же ключе.

Проверьте эндпоинт и отладьте первый разговор.

Сначала выполните curl к листингу моделей и держите вывод открытым; это авторитетное написание для каждого ID, который вы включаете, будь то через получение списка или вручную. Затем выполните один chat completion против ID, который планируете сделать дефолтом. Внутри LobeChat сначала отработайте проверку связи, прежде чем реальные разговоры. Ошибки аутентификации указывают на поле ключа. Пустой ответ указывает на суффикс /v1. Ошибки not-found на конкретной модели означают, что включённый ID не совпадает с листингом, что чаще всего случается после ручной правки отображаемых имён и ID вместе. Как только разговоры пойдут, консоль APIsRouter покажет модель на запрос, счётчики токенов и расходы. Чат-фреймворк с ассистентами генерирует трафик сразу по нескольким моделям, и вид использования по ключу — это то место, где привычка каждого ассистента становится расходом, видимым по модели, по дню.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.5-flash",
       "messages":[{"role":"user","content":"ping"}]}'

Частые вопросы

Как добавить кастомного OpenAI-совместимого провайдера в LobeChat?

В настройках откройте раздел провайдера AI-сервиса и создайте кастомного провайдера: ID и отображаемое имя, тип SDK OpenAI, эндпоинт https://api.apisrouter.com/v1 и свой ключ. Получите список моделей, включите нужные ID и запустите проверку связи.

Нужен ли URL эндпоинта суффикс /v1?

Для APIsRouter — да: https://api.apisrouter.com/v1. LobeChat дописывает маршруты вроде /chat/completions к base как есть, а в документации отмечается, что неверный суффикс обычно проявляется как пустой ответ на тесте. Если вы это увидите, исправьте суффикс и повторите.

Что такое OPENAI_PROXY_URL и когда его использовать?

Это переменная окружения для self-hosting, которая перенаправляет встроенного провайдера OpenAI в LobeChat на другой base URL. Задайте её вместе с OPENAI_API_KEY в контейнере, и каждый пользователь этого деплоя унаследует эндпоинт; используйте OPENAI_MODEL_LIST, чтобы курировать показываемые ID.

Могут ли разные ассистенты использовать разных вендоров через одного провайдера?

Да. Каждый ассистент закрепляет свою модель, и ID путешествует к эндпоинту как простая строка в каждом запросе. Одна запись провайдера может обслуживать ассистента Claude, ассистента GPT и ассистента DeepSeek бок о бок, все тарифицируются через один ключ.

Это тот же проект, что и LobeHub?

Да. Проект сменил бренд, и репозиторий GitHub теперь живёт на lobehub/lobehub, а старое имя lobe-chat редиректит туда. Документация и меню смешивают оба имени во время перехода, что также объясняет, почему подписи настроек различаются между релизами.

Почему мои полученные модели не появляются в разговорах?

Получение списка перечисляет ID; их включение — отдельный переключатель на каждую модель в списке моделей провайдера, а у самого провайдера тоже есть переключатель включения. Проверьте оба, затем заново откройте пикер моделей. Если включённый ID всё ещё выдаёт ошибку, сравните его написание с выводом /v1/models.