Konfiguracja API kompatybilnego z OpenAI w Open WebUI w 5 minut
Aby skonfigurować open webui openai compatible api, dodaj jedno połączenie z base URL i kluczem, a model pojawi się w selektorze. Oto dokładna konfiguracja dla Abliterated API, od Docker do pierwszego czatu.
Zaktualizowano

Kluczowe punkty
- Base URL to https://api.abliteratedapi.com/v1, a ID modelu to
uncensored. - Dodaj go w ustawieniach połączeń administratora lub przekaż OPENAI_API_BASE_URL i OPENAI_API_KEY do Dockera.
- Przetestuj klucz najpierw za pomocą curl, aby odróżnić problem z kluczem od problemu z interfejsem.
- Open WebUI to tylko interfejs: płacisz za tokeny za to, co model czyta i pisze, a do rozpoczęcia nie jest potrzebna karta.
Krótka wersja
Jeśli chcesz skonfigurować open webui openai compatible api w jednym akapicie: otwórz ustawienia administratora, dodaj połączenie OpenAI API, ustaw URL na https://api.abliteratedapi.com/v1, wklej swój klucz, zapisz i wybierz model o nazwie uncensored. To wszystko. Open WebUI komunikuje się z czymkolwiek, co implementuje format uzupełnień czatu OpenAI, a to API to robi.
Usługa to hostowane, kompatybilne z OpenAI API tekstowe obsługujące jeden model o otwartych wagach, dostrojone do odpowiadania bez odmów treści do zgodnego z prawem użytku przez dorosłych. Jest prowadzona przez niezależnego dostawcę i nie jest oficjalnym API żadnego laboratorium modeli. Open WebUI to tylko interfejs czatu, na który wskazujesz.
Zanim zaczniesz
- Klucz API. Utwórz go na stronie klucza API. Rejestracja odbywa się przez Google lub e-mail i hasło. Nowi użytkownicy mogą otrzymać $0,50 kredytu próbnego jednym kliknięciem na tej stronie, ważny przez 7 dni i bez wymagania karty.
- Działające Open WebUI. Instalacja Docker lub instalacja pip działają. Poniższe kroki obejmują Docker i ekran ustawień.
- Dostęp do sieci z maszyny uruchamiającej Open WebUI do
api.abliteratedapi.comprzez HTTPS.
Sprawdź klucz przed modyfikacją interfejsu. Jeśli to zapytanie zwraca listę zawierającą uncensored, klucz i URL są poprawne:
curl https://api.abliteratedapi.com/v1/models -H "Authorization: Bearer $ABLITERATED_API_KEY"
Następnie potwierdź, że rzeczywiste zapytanie o uzupełnienie czatu działa:
curl https://api.abliteratedapi.com/v1/chat/completions -H "Authorization: Bearer $ABLITERATED_API_KEY" -H "Content-Type: application/json" -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'Metoda 1: dodaj połączenie w ustawieniach
To najłatwiejsza droga i działa na istniejącej instalacji. Etykiety menu przesuwają się między wersjami Open WebUI, więc nazwy poniżej mogą się nieco różnić.
- Zaloguj się do Open WebUI jako administrator i otwórz Panel Administratora, następnie Ustawienia, następnie Połączenia.
- Znajdź sekcję OpenAI API i dodaj nowe połączenie przyciskiem plus.
- W polu URL wpisz
https://api.abliteratedapi.com/v1. Zatrzymaj się na/v1. Nie dodawaj/chat/completions; aplikacja Open WebUI dodaje tę ścieżkę samodzielnie. - Wklej swój klucz w polu klucza. Jest wysyłany jako
Authorization: Bearer <key>. - Użyj przycisku weryfikacji obok pól, jeśli Twoja wersja go ma, a następnie zapisz.
Otwórz nowy czat i otwórz selektor modeli. Model uncensored powinien być na liście, ponieważ Open WebUI odczytuje go z GET /v1/models. Jeśli lista pozostaje pusta, przejdź do sekcji rozwiązywania problemów poniżej.
Metoda 2: ustaw przy starcie za pomocą Dockera
Dla świeżej instalacji przekaż endpoint jako zmienne środowiskowe. Open WebUI odczytuje OPENAI_API_BASE_URL i OPENAI_API_KEY przy starcie.
# base URL: https://api.abliteratedapi.com/v1 model to pick in the UI: uncensored
docker run -d -p 3000:8080 -e OPENAI_API_BASE_URL="https://api.abliteratedapi.com/v1" -e OPENAI_API_KEY="$ABLITERATED_API_KEY" -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
Następnie odwiedź http://localhost:3000, utwórz pierwsze konto (stanie się administratorem) i rozpocznij czat. Wolumen nazwany przechowuje Twoje czaty i ustawienia przy aktualizacji kontenera.
Jedna rzecz często myli użytkowników: wiele ustawień Open WebUI jest zapisywanych w bazie danych po pierwszym uruchomieniu, a zapisana wartość może mieć pierwszeństwo przed zmienną środowiskową ustawioną później. Jeśli zmienisz klucz lub URL w Dockerze i nic się nie dzieje, zmień je w ekranie Połączenia lub zresetuj zapisaną konfigurację.
Ustawienia do dostosowania
Gdy czat działa, kilka opcji poprawia doświadczenie i utrzymuje rachunek przewidywalnym.
Używaj okna kontekstu rozsądnie
Okno kontekstu ma 100 000 tokenów, dzielonych między prompt i odpowiedź. Open WebUI ponownie wysyła historię czatu przy każdej wiadomości, więc długa rozmowa staje się droższa z każdą kolejną wiadomością. Przy $0,15 za 1M tokenów wejściowych, historia 20 000 tokenów kosztuje $0,003 do wysłania, co jest tanie, ale sumuje się przez tysiące wiadomości. Rozpocznij nowy czat dla nowego tematu.
Strumieniowanie i próbkowanie
Open WebUI strumieniuje odpowiedzi domyślnie, a API obsługuje strumieniowanie przez SSE. W zaawansowanych parametrach możesz ustawić temperaturę, top_p, sekwencje stop, ziarno dla powtarzalnego wyjścia i kary. Są one przekazywane do modelu. Pozostaw max_tokens puste, chyba że chcesz sztywnego limitu, ponieważ jest opcjonalny.
Zadania w tle
Open WebUI może wykonywać dodatkowe wywołania modelu w tle dla rzeczy takich jak nazwanie czatu. Każde z nich jest prawdziwym zapytaniem na Twoim saldzie i liczy się do limitów. Jeśli zauważysz wywołania, których nie wpisałeś, sprawdź ustawienia modelu zadań i wskaż je na model, za który chcesz płacić, lub wyłącz funkcje pomocnicze.
Presety i prompty systemowe
Open WebUI pozwala zapisać preset modelu w sekcji przestrzeni roboczej: nazwę, bazowy model, prompt systemowy i domyślne parametry. Utwórz jeden na podstawie uncensored dla każdej pracy, którą wykonujesz często, takiej jak asystent edycji, recenzent kodu lub postać do sesji fikcji interaktywnej. Krótki prompt systemowy, który określa rolę, ton i format odpowiedzi, robi więcej niż długie instrukcje wklejane do każdego czatu.
To jest miejsce, gdzie profil modelu pomaga. Jest to model o otwartych wagach dostrojony do odpowiadania bez odmów treści do zgodnego z prawem użytku przez dorosłych, co pasuje do fikcji, roleplay i aplikacji towarzyszących dla dorosłych, gdzie odmowa w środku sceny przerywa przepływ. Nie zmienia to twardego limitu: żadna treść seksualna z udziałem nieletnich, nigdy. Trzymaj presety i wspólne instancje w ramach tej zasady oraz prawa obowiązującego tam, gdzie mieszkasz.
Jeśli inni ludzie używają Twojej instancji Open WebUI, pamiętaj, że wszyscy dzielą Twój klucz i jego limity. Pełny klucz pozwala na 8 równoległych zapytań, więc garść aktywnych użytkowników jest w porządku, podczas gdy duża grupa czatująca jednocześnie może trafić na limit. Jeśli dasz każdej osobie lub zespołowi własny klucz, rozłożysz obciążenie i łatwiej będzie śledzić saldo.
Ile to kosztuje
Płacisz tylko za tokeny z przedpłaconego kredytu: $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych. Nieudane lub odrzucone zapytania nie są naliczane, a kredyt nigdy nie wygasa. Typowa wiadomość czatu z historią 3000 tokenów i odpowiedzią 400 tokenów kosztuje $0,00045 + $0,0002 = $0,00065, więc $10 zużycia to około 15 000 wiadomości.
Doładowania wynoszą od $20 do $500 w dowolnej kwocie całkowitej, z +5% od $50, +10% od $100 i +15% od $200. Możesz zapłacić kryptowalutą (USDT w TRC20, USDC na Base). Zobacz stronę z cenami, aby uzyskać szczegóły. Pozostałe środki są zwracane w nagłówku X-Balance-USD każdej odpowiedzi API, jeśli chcesz monitorować je ze skryptu.
Rozwiązywanie problemów
| Objaw | Prawdopodobna przyczyna | Naprawa |
|---|---|---|
| Lista modeli jest pusta | Zły URL lub klucz | Uruchom test curl dla /v1/models. URL musi kończyć się na /v1. |
| Odmowa połączenia lub timeout z Dockera | Brak wychodzącego HTTPS z kontenera | Sprawdź ustawienia DNS, proxy i zapory na hoście. |
| Błąd uwierzytelnienia przy każdej wiadomości | Klucz wklejony ze spacjami lub stary klucz | Skopiuj ponownie klucz ze strony kluczy i zapisz go ponownie. |
| Błędy podczas równoczesnej rozmowy wielu użytkowników | Limity zapytań | Pełny klucz pozwala na 8 równoległych zapytań i 300 na minutę; klucz próbny pozwala na 2 i 60. |
| Długie rozmowy przestają działać | Okno kontekstu pełne | Okno ma 100 000 tokenów. Rozpocznij nową rozmowę lub podsumuj tekst. |
Jeśli test curl przejdzie pomyślnie, ale Open WebUI zawodzi, problem leży w ustawieniach interfejsu. Jeśli curl zawodzi, najpierw sprawdź swój klucz i saldo. Szybki start w dokumentacji wymienia każdy parametr zapytania, a artykuł na temat czego API czatu uncensored nie jest i czym jest wyjaśnia zakres modelu, w tym ścisły limit: brak treści seksualnych z udziałem nieletnich.
Więcej przewodników
Pytania i odpowiedzi
Jaki URL wpisuję w Open WebUI?
Użyj https://api.abliteratedapi.com/v1 i nic więcej. Open WebUI dodaje /chat/completions i /models automatycznie.
Którą nazwę modelu wybrać?
ID modelu to uncensored. Pojawia się w selektorze modeli po zapisaniu połączenia i załadowaniu listy modeli.
Czy potrzebuję karty, żeby spróbować?
Nie. Nowi użytkownicy mogą uzyskać $0,50 kredytu próbnego jednym kliknięciem na stronie klucza API po rejestracji. Jest ważny przez 7 dni i nie wymaga karty.
Czy mogę uruchomić go obok modeli lokalnych?
Tak. Open WebUI obsługuje wiele połączeń jednocześnie, więc ten endpoint może współistnieć z modelami lokalnymi, a każdy z nich pojawi się w tym samym selektorze modeli.
Czy moje rozmowy są używane do trenowania?
Nie. Prompty wysłane do API nie są używane do trenowania. Historia czatu przechowywana przez Open WebUI pozostaje w Twojej własnej instalacji.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.
Pobierz klucz API