Wprowadzenie do ServBay AI Gateway

ServBay AI Gateway (brama AI) to wbudowana w ServBay lokalna, ujednolicona brama dostawców AI. Uruchamia na Twoim komputerze punkt końcowy proxy, który zbiera żądania kierowane do różnych dostawców dużych modeli językowych (OpenAI, Anthropic, DeepSeek, Qwen i niemal 20 innych) w jednym miejscu — pomaga centralnie zarządzać kluczami, śledzić zużycie i koszty oraz jednym kliknięciem wskazać lokalną bramę narzędziom do programowania z AI, takim jak Claude Code czy Codex.

Ten dokument wyjaśnia, czym jest brama AI, jakie problemy rozwiązuje i jak wygląda jej ogólna architektura. Szczegółowe instrukcje znajdziesz tutaj:

• Zarządzanie kanałami — dodawanie i konfiguracja dostawców
• Klucze wirtualne — tworzenie, ograniczanie uprawnień, rotacja i unieważnianie kluczy
• Przejęcie narzędzi AI jednym kliknięciem — wskazanie bramy narzędziom CLI pokroju Claude Code
• Statystyki i monitorowanie — zużycie, koszty i budżety
• Punkty końcowe i zmienne środowiskowe — wywoływanie bramy z własnego kodu

Przegląd

W codziennej pracy z AI możesz jednocześnie korzystać z kluczy API kilku dostawców, rozproszonych po plikach konfiguracyjnych różnych projektów i narzędzi — trudno wtedy policzyć wydatki, a jeszcze trudniej przełączać się między nimi w spójny sposób. ServBay AI Gateway sprowadza te problemy w jedno miejsce:

• Jedno wejście, wielu dostawców — po skonfigurowaniu kanałów wszystkie żądania są przekazywane przez lokalny adres http://127.0.0.1:11580, więc Twoja aplikacja widzi tylko jeden adres.
• Klucze wirtualne zamiast prawdziwych — brama wydaje aplikacjom i narzędziom „klucze wirtualne", a prawdziwe klucze API dostawców pozostają wyłącznie po stronie bramy i nie są już rozproszone po różnych miejscach. Klucz wirtualny możesz w każdej chwili ograniczyć, wymienić lub unieważnić.
• Ujednolicony widok zużycia i kosztów — wszystkie żądania przechodzące przez bramę są rejestrowane; brama udostępnia statystyki liczby żądań, zużycia tokenów, kosztów, opóźnień i użycia multimediów, a także obsługuje zarządzanie budżetem.
• Przejęcie popularnych narzędzi AI do programowania jednym kliknięciem — bez ręcznej edycji plików konfiguracyjnych brama jednym kliknięciem wskazuje lokalną bramę narzędziom takim jak Claude Code, Codex, Qwen Code, Kimi CLI, CodeBuddy, opencode czy Crush.
• Konta subskrypcyjne i śledzenie limitów — obsługa powiązania kont dostawców opartych na subskrypcji (np. autoryzacja OAuth dla Claude Pro / Max), wizualne prezentowanie informacji o planie, dostępnych punktach końcowych i limitach długości odpowiedzi oraz śledzenie w czasie rzeczywistym limitów w wielu oknach (procent wykorzystany / pozostały, status wyczerpania, czas resetu), dzięki czemu zawsze wiesz, ile środków w subskrypcji Ci zostało.
• Wykrywanie możliwości kanałów i inteligentne trasowanie — przy dodawaniu kanału brama automatycznie wykrywa możliwości dostawcy (typ z autoryzacją OAuth / typ pakietu do kodowania / typ modelu z poziomami) i po potwierdzeniu automatycznie zapisuje mapowanie bramy na trzech poziomach, bez ręcznego zgadywania zgodności modeli.

Architektura i porty

Brama AI składa się z dwóch lokalnych usług, z których obie nasłuchują wyłącznie na adresie pętli zwrotnej (127.0.0.1):

Port	Przeznaczenie	Opis
11580	Port proxy	Ujednolicone wejście dla aplikacji. Twój kod i przejęte narzędzia AI wysyłają tu żądania, a brama kieruje je do odpowiedniego kanału dostawcy zgodnie z uprawnieniami klucza wirtualnego.
11581	Port zarządzania	Służy wewnętrznemu zarządzaniu kanałami, kluczami i statystykami w aplikacji ServBay; zwykle nie ma potrzeby odwoływać się do niego bezpośrednio.

Port proxy udostępnia jednocześnie punkty końcowe w kilku zgodnych formatach (zgodne z OpenAI, Anthropic i Gemini) — szczegóły w Punkty końcowe i zmienne środowiskowe.

Obsługiwane kanały dostawców

Brama AI zawiera niemal 20 wbudowanych ustawień wstępnych dostawców, pogrupowanych według kategorii, które możesz wybrać podczas dodawania kanału:

• Główni (Mainstream): OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, OpenRouter.
• Chiny (China): DeepSeek, Qwen, Zhipu GLM, Kimi (Moonshot), Doubao·Volcano, Ernie Bot, Hunyuan, MiniMax, 01.AI, StepFun. W przypadku Qwen, Zhipu GLM, Kimi, Doubao·Volcano, Hunyuan, MiniMax i StepFun obsługiwane jest przełączanie między punktami końcowymi w regionie chińskim i globalnym.
• Lokalni (Local): Ollama (domyślnie 127.0.0.1:11434), LM Studio (domyślnie 127.0.0.1:1234).
• Własni (Custom): OpenAI Compatible (dowolna usługa zgodna z OpenAI), Custom (w pełni konfigurowalny).

Pełny proces dodawania i konfiguracji opisano w Zarządzanie kanałami.

Wymagania wstępne

• ServBay jest zainstalowany i uruchomiony na macOS lub Windows.
• Brama AI to funkcja rozszerzona ServBay — przed dodaniem kanału lub klucza musisz zalogować się na konto ServBay. Jeśli nie jesteś zalogowany, interfejs poprowadzi Cię przez proces logowania.

TIP

Brama AI działa identycznie w ServBay for macOS i ServBay for Windows — port proxy (11580), port zarządzania (11581) oraz ścieżki plików konfiguracyjnych przejmowanych narzędzi są takie same. Wszelkie różnice między platformami zostały opisane osobno w dokumentacji.

Konto i plan

Niektóre możliwości bramy AI są powiązane z planem konta ServBay:

• Limity liczby kanałów / kluczy — plany darmowe i płatne pozwalają na utworzenie różnej liczby kanałów i kluczy wirtualnych. Po osiągnięciu limitu interfejs zaproponuje aktualizację planu.
• Zarządzanie limitami i budżetem — ograniczenia według limitów (tokeny / liczba żądań / kwota) oraz panel budżetu należą do możliwości VIP / płatnych; bez subskrypcji odpowiednie obszary są zablokowane i wyświetlają propozycję aktualizacji.

Szczegóły planów znajdziesz w ServBay Pro i ServBay Team.

Konta subskrypcyjne i śledzenie limitów

Brama AI obsługuje powiązanie kont dostawców opartych na subskrypcji (np. Claude Pro / Max podłączone przez autoryzację OAuth), dzięki czemu możesz przeglądać i zarządzać tymi zasobami subskrypcyjnymi bezpośrednio w lokalnej bramie, bez logowania się do konsol internetowych poszczególnych dostawców.

Co dają konta subskrypcyjne

• Przejrzyste informacje o planie — nazwa subskrybowanego planu, struktura opłat i okres ważności.
• Dostępne punkty końcowe i limity odpowiedzi — lista punktów końcowych dostępnych dla danego konta subskrypcyjnego oraz maksymalna długość odpowiedzi dla poszczególnych modeli.
• Śledzenie limitów w wielu oknach — wizualizacja procentu wykorzystanego / pozostałego limitu, informacji o jego wyczerpaniu oraz czasu resetu, co pomaga rozsądnie rozdzielać zasoby subskrypcji.
• Widoczne wygaśnięcie poświadczeń — gdy dane autoryzacyjne konta subskrypcyjnego wygasną lub staną się nieważne, interfejs wyraźnie to oznaczy i przypomni o ponownej autoryzacji.

Funkcja eksperymentalna

Autoryzacja OAuth kont subskrypcyjnych jest obecnie funkcją eksperymentalną, a lista obsługiwanych dostawców będzie stopniowo się rozszerzać. Autoryzacja wymaga przejścia procesu OAuth dostawcy w przeglądarce; token autoryzacyjny jest przechowywany wyłącznie lokalnie.

Przechowywanie danych

• Konfiguracja kanałów, klucze wirtualne i statystyki zużycia są przechowywane lokalnie przez usługę backendu bramy.
• Klucz wirtualny w postaci jawnej jest wyświetlany tylko raz — przy tworzeniu (lub rotacji). Później brama zachowuje jedynie jego prefiks do identyfikacji, więc koniecznie skopiuj i zapisz klucz od razu po utworzeniu.
• Przy przejmowaniu narzędzi jednym kliknięciem brama najpierw tworzy kopię zapasową oryginalnego pliku konfiguracyjnego docelowego narzędzia z rozszerzeniem .bak, a następnie zapisuje konfigurację wskazującą na lokalną bramę, co ułatwia przywrócenie poprzedniego stanu w dowolnym momencie.

Typowy przebieg pracy

1. Zaloguj się na konto ServBay i przejdź do bramy AI.
2. Na stronie Kanały dodaj co najmniej jeden kanał dostawcy (np. OpenAI lub DeepSeek), wpisz prawdziwy klucz API i przetestuj połączenie.
3. Na stronie Klucze wirtualne utwórz klucz wirtualny i w razie potrzeby ogranicz dostępne modele / kanały oraz szybkość.
4. Na stronie Punkty końcowe wpisz klucz wirtualny do swojej aplikacji lub na tej samej stronie przejmij jednym kliknięciem używane narzędzia AI do programowania.
5. Na stronie Statystyki i monitorowanie obserwuj zużycie, koszty i opóźnienia, a w razie potrzeby ustaw budżet.

Podsumowanie

ServBay AI Gateway zamienia rozdrobniony obraz pracy z AI — „wielu dostawców, wiele kluczy, wiele narzędzi" — w „jedno lokalne wejście, jeden zestaw kluczy wirtualnych, jeden widok zużycia". Pozwala bezpiecznie zarządzać możliwościami AI lokalnie, precyzyjnie kontrolować koszty i przy minimalnym nakładzie podłączyć różnorodne narzędzia do programowania z AI do wspólnej bramy. To jedna z kluczowych możliwości ServBay dla programowania w duchu AI-native.