Uruchom LobeChat na niestandardowym endpoincie kompatybilnym z OpenAI.

Updated 2026-07-29

Moduł providerów LobeChat akceptuje dowolną usługę kompatybilną z OpenAI: utwórz niestandardowego providera z typem SDK OpenAI, ustaw endpoint na https://api.apisrouter.com/v1, wklej jeden klucz i pobierz listę modeli. Identyfikatory Claude, GPT, Gemini i DeepSeek trafiają do pickera modeli każdego asystenta.

Szybka odpowiedź: jeden niestandardowy provider, jeden endpoint, jeden klucz.

Otwórz ustawienia LobeChat i przejdź do sekcji dostawcy usługi AI (oznaczonej jako AI Service Provider albo Language Model, zależnie od wydania). Odkąd moduł zarządzania providerami wylądował w v1.44, możesz utworzyć niestandardowego providera zamiast doczepiać się do wbudowanego wpisu OpenAI: dodaj providera, nadaj mu identyfikator i nazwę wyświetlaną (apisrouter / APIsRouter), wybierz typ SDK OpenAI, a następnie wypełnij klucz API oraz proxy URL endpointu wartością https://api.apisrouter.com/v1. Na liście modeli providera użyj akcji pobierania modeli, żeby ściągnąć każdy identyfikator obsługiwany przez endpoint przez /v1/models, włącz te, których chcesz, i uruchom wbudowaną kontrolę połączenia. Od tej pory dowolny asystent albo konwersacja może wybrać te identyfikatory z pickera modeli. Projekt żyje teraz pod lobehub/lobehub na GitHubie (nazwa repozytorium lobe-chat przekierowuje tam), a etykiety menu przesuwają się między wydaniami, więc traktuj przepływ — wpis providera, typ SDK, URL, klucz, fetch — jako stabilną część, a nie dokładne brzmienie.

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

Jak LobeChat kieruje żądania do providera.

LobeChat (ok. 80 tys. gwiazdek na GitHubie, teraz pod nazwą LobeHub) to jeden z najczęściej wdrażanych open-source'owych frameworków czatu: dopracowany klient webowy, asystenci z własnymi promptami i modelami, system pluginów oraz funkcje bazy wiedzy, wdrażalny w sesji przeglądarki albo samodzielnie hostowany z bazą danych. Każdy wpis providera opisuje, dokąd idą żądania i jakim dialektem SDK mówić. Niestandardowy provider z typem SDK OpenAI wysyła standardowe żądania chat-completions do Twojego proxy URL, z identyfikatorem modelu jako zwykłym stringiem, dokładnie w kształcie, jakiego oczekuje wielodostawcowa bramka. Jeden wpis niesie więc cały katalog: asystenci mogą przypiąć claude-sonnet-4-6 do starannej pracy, podczas gdy szybkie konwersacje działają na gemini-3.5-flash, bez drugiego konta nigdzie. URL endpointu ma jeden udokumentowany niuans wart zacytowania: to, czy URL potrzebuje sufiksu /v1, zależy od usługi za nim. LobeChat dokleja ścieżki tras, takie jak /chat/completions, do podanej przez Ciebie bazy, więc dla APIsRouter poprawną wartością jest https://api.apisrouter.com/v1. Udokumentowanym objawem brakującego sufiksu jest model zwracający pustą odpowiedź w teście; jeśli to zobaczysz, dodaj /v1 i spróbuj ponownie.

Samodzielne hostowanie: ścieżka ze zmienną środowiskową.

Jeśli wdrażasz LobeChat samodzielnie, ten sam routing może trafić do kontenera zamiast być klikany w UI. Klasyczna para nadpisuje wbudowanego providera OpenAI: OPENAI_API_KEY przyjmuje klucz bramki, a OPENAI_PROXY_URL przyjmuje https://api.apisrouter.com/v1. Każdy użytkownik tego wdrożenia dziedziczy wtedy endpoint bez dotykania ustawień. Widoczność modeli jest kontrolowana składnią listy modeli: OPENAI_MODEL_LIST akceptuje +id, żeby dodać, -id, żeby ukryć, i id=Nazwa Wyświetlana, żeby przemianować, z wpisami rozdzielonymi przecinkami. Rozpoczęcie wartości od -all czyści wbudowaną listę, więc pokazują się tylko Twoje jawne identyfikatory, co jest czystym kształtem dla wyselekcjonowanego wdrożenia. Nowsze buildy serwerowe dokumentują też rodzinę CUSTOM_PROVIDER_* (count, id, name, type, base URL, keys) do deklarowania pełnych niestandardowych providerów w czasie wdrożenia, odpowiadającą temu, co robi moduł UI. Sprawdź aktualną referencję zmiennych środowiskowych dla Twojej wersji, zanim na niej polegasz, bo ta powierzchnia jest nowsza niż para OPENAI_* i wciąż się rozwija.

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

Dobór modeli dla asystentów.

Ponieważ wszyscy asystenci rozliczają się przez jeden klucz, porównanie modeli to zmiana ustawień asystenta. Przypnij dwóch kandydatów do dwóch zduplikowanych asystentów, uruchom swoje prawdziwe prompty przez tydzień i odczytaj wydatek per model w konsoli APIsRouter obok zaobserwowanej jakości odpowiedzi.

  • Asystenci to przypięcia modeli per rola. Asystent do pisania na claude-sonnet-4-6, asystent do szybkich odpowiedzi na claude-haiku-4-5-20251001 i asystent badawczy na gpt-5.5 współistnieją za jednym wpisem providera.
  • gemini-3.5-flash to wybór pod responsywność dla domyślnego modelu konwersacji; większość tur we frameworku czatu jest krótka, a szybkie modele utrzymują wrażenie natychmiastowości UI.
  • deepseek-v4-pro zarabia na slot do długich, wielojęzycznych konwersacji i intensywnego streszczania, gdzie jego zachowanie z długim kontekstem per wydany token jest atutem.
  • Konwersacje z obrazami potrzebują identyfikatora zdolnego do vision z włączoną możliwością w konfiguracji modelu providera; LobeChat udostępnia przełączniki możliwości per model w module providera.
  • Włącz świadomie picker dwupoziomowy, jeden szybki identyfikator i jeden flagowy, i dodawaj kolejne tylko wtedy, gdy naprawdę potrzebuje ich jakiś asystent; każdy włączony model to wiersz, który przewijają użytkownicy.

Płatność za użycie · poniżej cen oficjalnych

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

ModelCena oficjalnaNasza cena
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

Tryby awarii charakterystyczne dla LobeChat.

Pusta odpowiedź w kontroli połączenia to udokumentowana sygnatura problemu z sufiksem base URL. Dodaj albo usuń /v1 (dla APIsRouter musi być obecne) i spróbuj ponownie, zanim zaczniesz debugować cokolwiek głębiej. Modele brakujące w pickerze asystenta zwykle oznaczają, że zostały pobrane, ale nie włączone na liście modeli providera, albo że sam przełącznik providera jest wyłączony. Oba żyją na tym samym ekranie ustawień co akcja pobierania. Przy samodzielnie hostowanych wdrożeniach pamiętaj o pierwszeństwie: zmienne środowiskowe konfigurują domyślne ustawienia serwerowe, podczas gdy użytkownicy mogą wciąż wpisywać własne ustawienia providera po stronie klienta, zależnie od uwierzytelniania i flag funkcji Twojego wdrożenia. Jeśli wdrożenie ignoruje Twój OPENAI_PROXY_URL, potwierdź, że kontener faktycznie zrestartował się z nowym środowiskiem i że sesja klienta nie nadpisuje go lokalnie. Dryf wersji jest tu prawdziwy: drzewo ustawień było reorganizowane więcej niż raz (Language Model, potem AI Service Provider, z modułem providera przybywającym w v1.44), a zrzuty ekranu ze starszych tutoriali nie będą odpowiadać aktualnym menu. Same pola — id, name, typ SDK, URL, klucz — pozostały stabilne.

Kto kieruje LobeChat przez bramkę.

  • Osoby samodzielnie hostujące LobeChat dla zespołu, które chcą mieć jeden endpoint w kontenerze i jeden log użycia dla wszystkich, zamiast kluczy dostawcy per użytkownik.
  • Zaawansowani użytkownicy asystentów przypinający różnych dostawców per rola — Claude do pisania, GPT do analizy, DeepSeek do dużej objętości — bez utrzymywania kont na każdego z nich.
  • Użytkownicy, którzy chcą mieć modele, których nie niesie wbudowana lista providerów, włączane przez pobranie katalogu bramki zamiast czekania na wydania upstream.
  • Deweloperzy bez dostępu do rozliczeń danego dostawcy. Dostęp oparty na doładowaniu, bez wymogu karty, usuwa zależność od rejestracji u każdego dostawcy.
  • Osoby już kierujące swój edytor, launcher albo narzędzia CLI przez bramkę, które chcą, żeby ich framework czatu działał na tym samym kluczu.

Zweryfikuj endpoint i debuguj pierwszą konwersację.

Najpierw sprawdź curlem listę modeli i trzymaj output otwarty; to autorytatywna pisownia dla każdego identyfikatora, który włączasz, czy to przez fetch, czy ręcznie. Następnie uruchom jedno chat completion na identyfikatorze, który planujesz uczynić domyślnym. Wewnątrz LobeChat wykonaj kontrolę połączenia przed prawdziwymi konwersacjami. Awarie uwierzytelniania wskazują na pole klucza. Pusta odpowiedź wskazuje na sufiks /v1. Błędy not-found na konkretnym modelu oznaczają, że włączony identyfikator nie odpowiada liście, co najczęściej zdarza się po ręcznej edycji nazw wyświetlanych i identyfikatorów razem. Gdy konwersacje już płyną, konsola APIsRouter pokazuje model per żądanie, liczbę tokenów i wydatki. Framework czatu z asystentami generuje ruch na kilku modelach naraz, a widok użycia per klucz to miejsce, w którym przyzwyczajenie każdego asystenta staje się kosztem widocznym per model, per dzień.

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"}]}'

Częste pytania

Jak dodać niestandardowego providera kompatybilnego z OpenAI do LobeChat?

W ustawieniach otwórz sekcję dostawcy usługi AI i utwórz niestandardowego providera: identyfikator i nazwa wyświetlana, typ SDK OpenAI, endpoint https://api.apisrouter.com/v1 i Twój klucz. Pobierz listę modeli, włącz identyfikatory, których chcesz, i uruchom kontrolę połączenia.

Czy URL endpointu potrzebuje /v1?

Dla APIsRouter tak: https://api.apisrouter.com/v1. LobeChat dokleja trasy, takie jak /chat/completions, do podanej przez Ciebie bazy, a jej dokumentacja zaznacza, że błędny sufiks zwykle objawia się pustą odpowiedzią w teście. Jeśli to zobaczysz, popraw sufiks i spróbuj ponownie.

Czym jest OPENAI_PROXY_URL i kiedy go używać?

To zmienna środowiskowa do samodzielnego hostowania, która przekierowuje wbudowanego providera OpenAI w LobeChat na inny base URL. Ustaw ją razem z OPENAI_API_KEY w kontenerze, a każdy użytkownik tego wdrożenia dziedziczy endpoint; użyj OPENAI_MODEL_LIST, żeby wyselekcjonować, które identyfikatory się pokazują.

Czy różni asystenci mogą używać różnych dostawców przez jednego providera?

Tak. Każdy asystent przypina własny model, a identyfikator podróżuje do endpointu jako zwykły string per żądanie. Jeden wpis providera może obsługiwać asystenta Claude, asystenta GPT i asystenta DeepSeek obok siebie, wszystkich rozliczanych przez ten sam klucz.

Czy LobeChat to ten sam projekt co LobeHub?

Tak. Projekt zmienił markę, a repozytorium na GitHubie żyje teraz pod lobehub/lobehub, przy czym stara nazwa lobe-chat przekierowuje. Dokumentacja i menu mieszają obie nazwy podczas przejścia, co jest też powodem, dla którego etykiety ustawień różnią się między wydaniami.

Dlaczego moje pobrane modele nie pojawiają się w konwersacjach?

Pobieranie listuje identyfikatory; włączanie ich to osobny przełącznik per model na liście modeli providera, a sam provider ma przełącznik włączenia. Sprawdź oba, a następnie ponownie otwórz picker modeli. Jeśli włączony identyfikator wciąż zawodzi, porównaj jego pisownię z outputem /v1/models.