Dokumentation

Open WebUI

Open WebUI behandelt jeden OpenAI-kompatiblen Endpunkt als Verbindung. Fügen Sie eine Verbindung in den Administratoreinstellungen hinzu oder legen Sie beim Start des Containers zwei Umgebungsvariablen fest — beide Wege führen zum selben Ergebnis.

Eine OpenAI-Verbindung unter Admin Settings oder OPENAI_API_BASE_URL und OPENAI_API_KEY beim Containerstart — beide enden am selben /v1.

Verbindung oder docker run

# Settings → Admin Settings → Connections → Manage OpenAI API Connections → +
URL                https://api.kunavo.com/v1
API Key            sk-kn-...
Model IDs (Filter) claude-sonnet-5, claude-opus-5, claude-haiku-4-5, gpt-5-6-terra

# …or at container start, same thing:
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.kunavo.com/v1 \
  -e OPENAI_API_KEY=sk-kn-... \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main

Füllen Sie Model IDs (Filter) aus. Ohne diesen Filter führt die Modellauswahl den gesamten Katalog auf — einschließlich Bild-, Video- und Musikmodellen, die ein Chatfenster nicht aufrufen kann. Der erste Klick eines Benutzers führt dann zu einem dieser Modelle. Der Filter ist auch dann hilfreich, wenn ein Endpunkt keine /models-Route hat. Kunavo hat eine, daher ist die Verifizierung in beiden Fällen erfolgreich.

Die URL behält /v1 bei. Wenn Open WebUI in Docker läuft und Sie auf etwas auf demselben Host verweisen, ersetzen Sie localhost durch host.docker.internal — das trifft auf einen gehosteten Endpunkt nicht zu, ist aber der Fehler, der unmittelbar nach diesem hier auftritt.

Noch kein Schlüssel? Erstelle ein Kunavo-Konto, erstelle einen Schlüssel (er beginnt mit sk-kn-) und füge ab $10 Guthaben hinzu – Aufrufe werden aus diesem Guthaben bezahlt, fehlgeschlagene Aufrufe werden nicht berechnet. Das Dashboard öffnet anschließend die Open WebUI-Einrichtung.

Schritt für Schritt

Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
Navigieren Sie in Open WebUI zu Einstellungen → Administration → Verbindungen und suchen Sie OpenAI-API-Verbindungen verwalten.
Klicken Sie auf ➕ Verbindung hinzufügen und geben Sie URL und API-Schlüssel ein.
Fügen Sie die gewünschten IDs zu Model IDs (Filter) hinzu, speichern Sie und lassen Sie die Verbindung verifizieren.
Starten Sie einen neuen Chat — die Modelle erscheinen in der Auswahl mit dem Verbindungsnamen als Präfix.

Abgeglichen mit Der Leitfaden von Open WebUI zu OpenAI-kompatiblen Providern am 6. September 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in Open WebUI.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Modell-ID	Kunavo: Ein- und Ausgabe	Wo es in Open WebUI hineinpasst
`claude-sonnet-5`	$1.40 / $7.00	der allgemeine Chat-Standard
`claude-opus-5`	$3.50 / $17.50	lange analytische Dialoge
`claude-haiku-4-5`	$0.70 / $3.50	schnell, günstig und für die meisten Gesprächsrunden ausreichend
`gpt-5-6-terra`	$0.70 / $4.20	lange Dokumente, die in das Chatfenster eingefügt werden

Die Abrechnung erfolgt pro Token aus einem vorausbezahlten Guthaben ohne Monatsgebühr – siehe Abrechnung. Bei wiederholtem Kontext – dem Großteil dessen, was ein Editor oder Chat-Client sendet – verändert Prompt-Caching die Rechnung stärker als die Modellwahl.

Häufig gestellte Fragen

Wie verbinde ich Open WebUI mit einer OpenAI-kompatiblen API?

Gehen Sie zu Einstellungen → Administration → Verbindungen, öffnen Sie „OpenAI-API-Verbindungen verwalten“ und klicken Sie auf „Verbindung hinzufügen“. Geben Sie dann die Endpunkt-URL — die /v1-Basis — und den API-Schlüssel ein. Dasselbe erreichen Sie beim Start des Containers mit den Umgebungsvariablen OPENAI_API_BASE_URL und OPENAI_API_KEY. Beide Wege erstellen dieselbe Verbindung.

Wozu dient Model IDs (Filter) in Open WebUI?

Damit wird festgelegt, welche Modell-IDs dieser Verbindung in der Auswahl erscheinen. Außerdem dient der Filter als Ausweichmöglichkeit für Endpunkte, die keine /models-Route bereitstellen: Dort fügen Sie IDs manuell hinzu. Die Verifizierung schlägt dann fehl, obwohl der Chat weiterhin funktioniert. Bei einem Gateway mit einem großen multimodalen Katalog lohnt es sich in jedem Fall, den Filter festzulegen, damit in der Chat-Auswahl nur Modelle erscheinen, die ein Chatfenster tatsächlich aufrufen kann.

Enthält die Open WebUI-Basis-URL /v1?

Ja. Open WebUI hängt an die angegebene URL nur die Route an. Die Verbindungs-URL ist daher die /v1-Basis — https://api.example.com/v1. Auch die Beispiel-Endpunkte in der Dokumentation enthalten diesen Suffix. Ohne ihn wird die Verbindung zwar gespeichert, aber jede Anfrage endet mit einem 404-Fehler.

Kann Open WebUI Claude- und GPT-Modelle verwenden?

Ja, sofern sie über einen OpenAI-kompatiblen Endpunkt bereitgestellt werden. Open WebUI übermittelt die Modell-ID direkt an die Verbindungs-URL. Daher werden IDs beliebiger Anbieter am Endpunkt statt in Open WebUI aufgelöst. So können Claude- und GPT-IDs in derselben Modellauswahl mit einer Verbindung und einem Schlüssel erscheinen.