LobeChat (LobeHub) с Claude и GPT через свой API

Да. LobeChat теперь называется LobeHub: репозиторий GitHub lobehub/lobe-chat перенаправляет на lobehub/lobehub, документация использует новое название, а Docker-образ называется lobehub/lobehub. Это приложение с открытым кодом для чата и агентов: его можно использовать в браузере, как десктопное приложение или развернуть у себя. Каждый агент выбирает провайдера и модель, так что для одной задачи можно взять Claude, а для другой — GPT.

Руководство соответствует документации LobeHub и подписям интерфейса на октябрь 2026 года.

В LobeHub есть три способа подключить APIVAI:

Правило для /v1: URL в формате OpenAI заканчивается на /v1; URL в формате Anthropic — нет, потому что Anthropic SDK сам добавляет /v1/messages. LobeHub к тому же убирает /v1 в конце адреса Anthropic, но правильное значение — https://api.apivai.com. Подробнее о форматах: OpenAI-совместимый API и прокси для Claude API.

1. Зарегистрируйтесь по email.
2. Пополните баланс от $10 картой, криптовалютой, через Alipay или WeChat Pay. Оплата за токены, без подписки.
3. Создайте ключ в Панели и скопируйте его. Если им будут пользоваться несколько человек, задайте лимит бюджета.

1. Откройте App Settings → AI Providers.
2. Нажмите Add Custom Provider. Откроется окно Create Custom AI Provider.
3. Заполните поля по таблице ниже и нажмите Create.
4. На странице нового провайдера воспользуйтесь Connectivity Check: выберите модель и нажмите Check. Должно появиться Check passed.
5. В списке моделей нажмите Fetch models, чтобы загрузить ID из /v1/models, и включите нужные. Можно также нажать Add Model и ввести Model ID вручную.
6. Откройте настройки агента и выберите провайдера APIVAI и модель.

Use Client Request Mode отправляет запросы прямо из браузера, а не через сервер LobeHub. Оставьте его выключенным, если нет причины менять; если вы его включили и видите сетевые ошибки, выключите снова.

Выберите Anthropic в AI Providers, включите его, вставьте ключ APIVAI в API Key и укажите https://api.apivai.com в API Proxy URL. Выполните Check и включите модели Claude. ID модели должен совпадать с ID в APIVAI, например claude-sonnet-4-6; если у встроенной карточки модели другой ID, добавьте правильный через Add Model. Если Fetch models в этом режиме ничего не возвращает, добавьте ID вручную. Свой провайдер с Request Format Anthropic и тем же URL работает так же.

Выберите OpenAI, вставьте ключ и укажите в API Proxy URL адрес https://api.apivai.com/v1. Оставьте Use Responses API Specification выключенным: по описанию LobeHub эта опция поддерживается только моделями OpenAI, а через этого провайдера вы будете отправлять и запросы к Claude.

Самостоятельно развёрнутый сервер LobeHub читает настройки провайдеров из переменных окружения. Добавьте их в файл lobehub.env из руководства по Docker рядом с уже нужными переменными базы данных и авторизации:

Затем запустите контейнер как обычно, например docker run -d -p 3210:3210 --env-file lobehub.env --name lobehub lobehub/lobehub, и перезапускайте его после каждого изменения файла.

OPENAI_MODEL_LIST использует синтаксис списка моделей LobeHub: -all скрывает модели OpenAI по умолчанию, +id добавляет модель, а id=Display Name переименовывает её. Ключ, заданный так, — серверный, его используют все пользователи вашего экземпляра, поэтому задайте ему отдельный бюджет в Панели APIVAI. В документации LobeHub отмечено, что пустой ответ часто означает отсутствие /v1 в OPENAI_PROXY_URL; для APIVAI всегда указывайте его.

Чат полностью работает через APIVAI. Но файлам и базе знаний нужна ещё модель эмбеддингов для индексации документов, а APIVAI эмбеддинги не предоставляет.

По умолчанию LobeHub создаёт эмбеддинги моделью OpenAI text-embedding-3-small через провайдера OpenAI. Если вы направили OPENAI_PROXY_URL на APIVAI, индексация файлов не сработает — это ещё одна причина использовать для чата свой провайдер. Настройте отдельного провайдера эмбеддингов через DEFAULT_FILES_CONFIG, например DEFAULT_FILES_CONFIG=embedding_model=ollama/<ваша-модель-эмбеддингов>; поддерживаемые провайдеры перечислены в руководстве LobeHub по базе знаний. Ответы по вашим файлам по-прежнему даёт модель чата через APIVAI.

Цены за миллион токенов на 2026-10-07. Список меняется, поэтому берите ID из GET https://api.apivai.com/v1/models (или через Fetch models) и со страницы цен.

Практичная схема: Claude Haiku 4.5 или GPT-6 Luna для агента-помощника общего назначения, Claude Sonnet 4.6 для агентов, которые пишут тексты и код, и Claude Opus 5.5 только для агента, который берёт на себя самую сложную работу.

APIVAI списывает оплату за токены с предоплаченного баланса. Каждое сообщение заново отправляет историю разговора, поэтому в длинных чатах одно сообщение стоит дороже.

Пример 1: ежедневное личное использование. 50 сообщений в день в течение 30 дней, каждое примерно на 3 000 входных и 800 выходных токенов: 1 500 сообщений стоят $10.94 на Claude Sonnet 4.6 ($31.50 по официальным ценам) или $0.157 на GPT-6 Luna.

Пример 2: работа с большими документами. Агент, который читает длинные тексты: 10 запросов в рабочий день за 22 рабочих дня, каждый примерно на 20 000 входных и 1 500 выходных токенов. 220 запросов стоят $4.18 на Claude Sonnet 5.5 против $12.10 по официальным ценам.

Панель показывает токены и стоимость каждого запроса. В сравнении цен Claude API все модели приведены рядом с официальными ценами.

• 401 или «API key invalid»: проверьте ключ на лишние пробелы, убедитесь, что он не удалён, и проверьте его бюджет и ваш баланс в Панели.
• 404: неверный /v1 в URL. Формату OpenAI (свой провайдер, провайдер OpenAI, OPENAI_PROXY_URL) нужен https://api.apivai.com/v1; формату Anthropic — https://api.apivai.com. Никогда не добавляйте /chat/completions или /messages.
• Модель не найдена: Model ID должен точно совпадать с ID в APIVAI, например claude-sonnet-4-6, а не с отображаемым названием. Используйте Fetch models или GET /v1/models.
• Пустые или обрезанные ответы: размышления включены по умолчанию, и их токены считаются выходными. В настройках модели агента включите Enable Max Tokens Limit и задайте Max Tokens Limit 4096 или больше. Если ответы пустые в формате OpenAI, проверьте также, что URL заканчивается на /v1.
• Переменные окружения не действуют: перезапустите контейнер после правки lobehub.env и проверьте, что имена переменных написаны точно как выше.
• 429: по умолчанию 60 запросов в минуту на ключ. Если общий экземпляр упирается в лимит, попросите поддержку его увеличить.

Да. LobeChat переименовали в LobeHub; репозиторий, документация и Docker-образ теперь используют название LobeHub. Настройки, которые в старых руководствах описаны для LobeChat, находятся в App Settings → AI Providers.

Да, через свой провайдер в формате OpenAI с адресом https://api.apivai.com/v1. Один ключ APIVAI работает со всеми моделями со страницы цен.

Нет. Docker нужен, только если вы запускаете собственный сервер LobeHub. В любом приложении LobeHub, где есть раздел AI Providers, APIVAI можно добавить в настройках, как описано выше.

APIVAI не записывает содержимое запросов и ответов. Историю чатов хранит LobeHub — на вашем сервере, если вы развернули его сами.

Нет. APIVAI работает по предоплате с оплатой по факту, от $10 и без подписки. Настройка других инструментов — в документации, а ещё один самостоятельно размещаемый интерфейс описан в руководстве по Open WebUI.

Создайте аккаунт, пополните баланс от $10 и вставьте ключ в LobeHub.