Запустіть 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 з пікера моделей. Проєкт тепер живе за адресою lobehub/lobehub на GitHub (назва репозиторію lobe-chat перенаправляє туди), і назви меню зсуваються між релізами, тож трактуйте процес — запис провайдера, тип SDK, URL, ключ, fetch — як стабільну частину, а не точне формулювання.
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 (приблизно 80 тис. зірок на GitHub, тепер під назвою LobeHub) — один із найбільш розгорнутих фреймворків чату з відкритим кодом: відшліфований веб-клієнт, асистенти з власними промптами і моделями, система плагінів і функції бази знань, розгортуваний у сесії браузера чи самостійно хостований з базою даних. Кожен запис провайдера описує, куди йдуть запити і яким діалектом 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 і спробуйте знову.
Самостійний хостинг: шлях через змінну середовища.
Якщо ви розгортаєте LobeChat самостійно, ту саму маршрутизацію можна постачати в контейнері, а не клацати в інтерфейсі. Класична пара перевизначає вбудований провайдер 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 — вибір для швидкості реакції як типова модель розмови; більшість ходів у фреймворку чату короткі, і швидкі моделі тримають відчуття миттєвості інтерфейсу.
- deepseek-v4-pro заслуговує на слот для довгих багатомовних розмов і насиченого резюмування, де приваблює її поведінка з довгим контекстом на витрачений токен.
- Розмови із зображеннями потребують ID, здатного до зору, з увімкненою можливістю в конфігурації моделі провайдера; LobeChat відкриває перемикачі можливостей для кожної моделі в модулі провайдера.
- Свідомо вмикайте дворівневий пікер — один швидкий ID і один передовий 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 він має бути присутнім) і спробуйте знову, перш ніж налагоджувати щось глибше. Відсутні моделі в пікері асистента зазвичай означають, що їх отримали, але не увімкнули в списку моделей провайдера, або сам перемикач провайдера вимкнений. Обидва живуть на тому самому екрані налаштувань, що й дія отримання. У самостійно хостованих розгортаннях пам'ятайте про пріоритет: змінні середовища налаштовують серверні значення за замовчуванням, тоді як користувачі все ще можуть вводити власні налаштування провайдера на боці клієнта, залежно від автентифікації і прапорців функцій вашого розгортання. Якщо розгортання ігнорує ваш OPENAI_PROXY_URL, підтвердьте, що контейнер справді перезапустився з новим середовищем і що сесія клієнта не перевизначає його локально. Дрейф версій тут реальний: дерево налаштувань реорганізовувалось не раз (Language Model, тоді AI Service Provider, з модулем провайдера, що з'явився у v1.44), і скріншоти зі старіших туторіалів не збігатимуться з поточними меню. Самі поля — id, name, SDK type, URL, ключ — лишались стабільними.
Хто маршрутизує LobeChat через шлюз.
- Ті, хто самостійно хостить LobeChat для команди і хоче мати один ендпоінт у контейнері й один журнал використання для всіх, замість ключів постачальника для кожного користувача.
- Досвідчені користувачі асистентів, що закріплюють різних постачальників для кожної ролі — Claude для письма, GPT для аналізу, DeepSeek для обсягу — не підтримуючи акаунти на кожного.
- Користувачі, які хочуть моделі, яких немає у вбудованому списку провайдерів, увімкнені шляхом отримання каталогу шлюзу, а не очікуванням на релізи вгору за течією.
- Розробники без доступу до білінгу певного постачальника. Доступ на основі поповнення без вимоги картки прибирає залежність від реєстрації в кожного провайдера.
- Люди, що вже маршрутизують свій редактор, лаунчер чи інструменти CLI через шлюз і хочуть тримати свій фреймворк чату на тому самому ключі.
Перевірте ендпоінт і налагодьте першу розмову.
Спершу виконайте curl для списку моделей і тримайте вивід відкритим; це авторитетне написання для кожного ID, який ви вмикаєте, чи то через fetch, чи вручну. Тоді запустіть один chat completion проти ID, який плануєте зробити типовим. Всередині LobeChat опрацюйте перевірку з'єднання перед реальними розмовами. Збої автентифікації вказують на поле ключа. Порожня відповідь вказує на суфікс /v1. Помилки «не знайдено» для конкретної моделі означають, що увімкнений 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 і коли його використовувати?
Це змінна середовища для самостійного хостингу, яка перенаправляє вбудований провайдер OpenAI LobeChat на інший base URL. Встановіть її разом з OPENAI_API_KEY у контейнері, і кожен користувач цього розгортання успадковує ендпоінт; використовуйте OPENAI_MODEL_LIST, щоб курувати, які ID показувати.
Чи можуть різні асистенти використовувати різних постачальників через одного провайдера?
Так. Кожен асистент закріплює власну модель, і ID подорожує до ендпоінта як звичайний рядок на кожен запит. Один запис провайдера може обслуговувати асистента Claude, асистента GPT і асистента DeepSeek пліч-о-пліч, усі оплачуються через той самий ключ.
Чи LobeChat — той самий проєкт, що й LobeHub?
Так. Проєкт пройшов ребрендинг, і репозиторій GitHub тепер живе за адресою lobehub/lobehub, зі старою назвою lobe-chat, що перенаправляє туди. Документація і меню змішують обидві назви під час переходу, що також пояснює, чому назви налаштувань різняться між релізами.
Чому отримані моделі не з'являються в розмовах?
Отримання перелічує ID; їхнє увімкнення — окремий перемикач для кожної моделі в списку моделей провайдера, а сам провайдер має перемикач увімкнення. Перевірте обидва, тоді знову відкрийте пікер моделей. Якщо увімкнений ID усе ще видає помилку, порівняйте його написання з виводом /v1/models.