Entwickler-Ressourcen

Open WebUI

Open WebUI installieren, RunAPI als OpenAI-kompatible Verbindung hinzufügen, ein Modell auswählen und einen Chat überprüfen.

Markdown anzeigen

Open WebUI über seine OpenAI-kompatible Verbindung mit RunAPI verbinden. Sie benötigen Open WebUI-Administratorzugriff und einen Standard-RunAPI-API-Schlüssel aus der Authentifizierungsanleitung.

Open WebUI installieren

Folgen Sie der offiziellen Open WebUI-Schnellstartanleitung für Ihre Plattform. Für eine lokale Docker-Installation kann das offizielle Image gestartet werden mit:

SHELL

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

Öffnen Sie die Anwendung, erstellen Sie das Administratorkonto und melden Sie sich an, bevor Sie die Verbindung hinzufügen.

RunAPI-Verbindung hinzufügen

Öffnen Sie Admin Settings → Connections → OpenAI und wählen Sie Add Connection.
Setzen Sie die URL auf https://runapi.ai/v1 und geben Sie Ihren RunAPI-API-Schlüssel ein.
Lassen Sie Model IDs (Filter) beim ersten Verbindungsversuch leer, damit Open WebUI die verfügbaren Modelle ermitteln kann.
Speichern Sie die Verbindung und warten Sie, bis die Überprüfung abgeschlossen ist.

Open WebUI sendet die Verbindungsprüfung von seinem Backend aus und verwendet GET /v1/models zur Erkennung. Die RunAPI-URL ist öffentliches HTTPS, sodass eine Docker-Installation für diese Verbindung kein host.docker.internal benötigt.

Ein Modell auswählen

Öffnen Sie einen neuen Chat und wählen Sie ein RunAPI-Modell aus der Chat-Modellauswahl. Verwenden Sie den Modellkatalog, um den aktuellen Modellbezeichner und die Funktionen zu bestätigen.

Wenn die Discovery den Selektor nicht befüllt, bearbeiten Sie die Verbindung und fügen Sie den genauen Bezeichner unter Model IDs (Filter) hinzu. Ein Modell-Discovery-Fehler und ein Chat Completions-Fehler sind separate Signale; testen Sie das manuell hinzugefügte Modell, bevor Sie die Verbindung entfernen.

Verbindung überprüfen

Senden Sie einen kurzen Prompt wie Reply with the word connected. Eine normale gestreamte oder vollständige Antwort bestätigt, dass Open WebUI das ausgewählte RunAPI-Modell verwenden kann.

Fehlerbehebung

Überprüfung gibt 401 oder 403 zurück: Ersetzen Sie den API-Schlüssel in der Verbindung durch einen gültigen Standard-Schlüssel aus der Authentifizierungsanleitung.
Kein RunAPI-Modell erscheint: Vergewissern Sie sich, dass die URL auf /v1 endet, fügen Sie dann eine aktuelle Kennung zu Model IDs (Filter) hinzu und wiederholen Sie den Chat.
Das Modell ist sichtbar, aber der Chat schlägt fehl: Vergewissern Sie sich, dass die Kennung OpenAI-kompatible Chat Completions im Modellkatalog unterstützt, und prüfen Sie dann die Open WebUI-Backend-Logs auf den Anfragestatus.
Eine lokale URL funktioniert im Browser, aber nicht in Open WebUI: Open WebUI-Verbindungen stammen von dessen Backend. Dies betrifft nicht die öffentliche URL https://runapi.ai/v1, ist aber für andere lokale Verbindungen relevant.

Für das gemeinsame Protokollverhalten verwenden Sie den LLM API Quickstart. Für Anfrage- und Antwortfelder verwenden Sie die Chat Completions API Referenz.