Przejdź do treści
Zasoby dla deweloperów
Zasoby dla deweloperów

Open WebUI

Zainstaluj Open WebUI, dodaj RunAPI jako połączenie zgodne z OpenAI, wybierz model i zweryfikuj czat.

Zobacz Markdown

Połącz Open WebUI z RunAPI przez połączenie zgodne z OpenAI. Potrzebujesz dostępu administratora Open WebUI oraz standardowego klucza API RunAPI z Przewodnika uwierzytelniania.

Instalacja Open WebUI

Postępuj zgodnie z oficjalnym przewodnikiem Szybki start Open WebUI dla swojej platformy. W przypadku lokalnej instalacji Docker oficjalny obraz można uruchomić poleceniem:

SHELL 
docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main

Otwórz aplikację, utwórz konto administratora i zaloguj się przed dodaniem połączenia.

Dodaj połączenie RunAPI

  1. Otwórz Admin Settings → Connections → OpenAI, a następnie wybierz Add Connection.
  2. Ustaw adres URL na https://runapi.ai/v1 i wprowadź swój klucz API RunAPI.
  3. Pozostaw pole Model IDs (Filter) puste przy pierwszej próbie połączenia, aby Open WebUI mogło wykryć dostępne modele.
  4. Zapisz połączenie i poczekaj na zakończenie weryfikacji.

Open WebUI wysyła sprawdzenie połączenia ze swojego backendu i używa GET /v1/models do wykrywania. Adres URL RunAPI jest publicznym adresem HTTPS, więc instalacja Docker nie wymaga host.docker.internal dla tego połączenia.

Wybierz model

Otwórz nowy czat i wybierz model RunAPI z selektora modeli czatu. Skorzystaj z Katalogu modeli, aby potwierdzić bieżący identyfikator modelu i jego możliwości.

Jeśli wykrywanie nie wypełnia selektora, edytuj połączenie i dodaj dokładny identyfikator w polu Model IDs (Filter). Błąd wykrywania modelu i błąd Chat Completions to osobne sygnały; przetestuj ręcznie dodany model przed usunięciem połączenia.

Weryfikuj połączenie

Wyślij krótki monit, np. Reply with the word connected. Normalna odpowiedź strumieniowa lub kompletna potwierdza, że Open WebUI może używać wybranego modelu RunAPI.

Rozwiązywanie problemów

  • Weryfikacja zwraca 401 lub 403: zastąp klucz API w połączeniu prawidłowym kluczem standardowym z Przewodnika po uwierzytelnianiu.
  • Brak modelu RunAPI: upewnij się, że adres URL kończy się na /v1, a następnie dodaj jeden aktualny identyfikator do Model IDs (Filter) i ponów próbę czatu.
  • Model jest widoczny, ale czat nie działa: upewnij się, że identyfikator obsługuje Chat Completions zgodne z OpenAI w Katalogu modeli, a następnie sprawdź logi backendu Open WebUI pod kątem statusu żądania.
  • Lokalny adres URL działa w przeglądarce, ale nie w Open WebUI: połączenia Open WebUI pochodzą z jego backendu. Nie ma to wpływu na publiczny adres URL https://runapi.ai/v1, ale ma znaczenie dla innych połączeń lokalnych.

W przypadku wspólnego zachowania protokołu skorzystaj z Szybkiego startu LLM API . W przypadku pól żądania i odpowiedzi skorzystaj z Dokumentacji interfejsu Chat Completions API.