Einrichtung des Open WebUI API-Schlüssels

Open WebUI API-Schlüssel: Legen Sie Ihren eigenen Schlüssel unter Verbindungen fest

Füllen Sie diese Felder unter Verbindungen im Admin-Panel mit Ihrem eigenen API-Schlüssel aus, und Open WebUI kann Claude-Modelle verwenden. Zahlen Sie nur, was Sie nutzen.

Admin-Panel → Einstellungen → VerbindungenUI
config
Admin Panel → Settings → Connections → OpenAI API → +
URL: https://api.aicodewith.ai/v1
API Key: sk-***
Save → new chat → model selector → claude-haiku-4-5-20251001

Einrichtungsschritte

Diesen Schlüssel für spätere Terminals speichern

Dieses Tool speichert den Schlüssel in seinen eigenen Einstellungen. Nachdem Sie sich angemeldet haben, kopieren Sie den Schlüssel und fügen Sie ihn in das API Key-Feld in den folgenden Schritten ein.

API Key
sk-***

Nicht angemeldete Besucher sehen nur einen Platzhalter. Melden Sie sich an, dann tragen wir Ihren Schlüssel ein. Sign in · Einen Schlüssel in der Konsole abrufen

Durch das Kopieren wird der Befehl nur in die Zwischenablage gelegt. Sie müssen ihn weiterhin in einem Terminal ausführen oder den Schlüssel in die Tool-Einstellungen einfügen. So erhalten Sie einen API-Schlüssel

Diese Schritte wurden unter Linux (Open WebUI v0.12.0) getestet. macOS und Windows wurden noch nicht getestet, daher sind sie nicht aufgeführt.

  1. Noch kein Open WebUI? Installiere es (überspringen, falls installiert)

    Führe uv tool install open-webui aus, dann uv tool list | grep open-webui. Wenn open-webui mit einer Version aufgelistet wird, ist es installiert. Führe dann open-webui serve aus und öffne die im Terminal angezeigte Adresse.

    Führe uv tool list | grep open-webui aus, um zu bestätigen, dass Open WebUI v0.12.0 installiert ist (Version rot umrandet)
  2. Klicke auf deinen Avatar und öffne Admin Panel

    Klicke auf der Open WebUI-Startseite unten links auf deinen Avatar und dann im Menü auf Admin Panel.

    Öffne die Open WebUI-Startseite und klicke unten links auf deinen Avatar; der Eintrag Admin Panel im Menü ist rot umrandet
  3. Klicke oben auf Settings

    Klicke auf der Admin Panel-Seite oben auf den Tab Settings.

    Klicke auf der Admin Panel-Seite oben auf den Tab Settings (rot umrandet)
  4. Klicke links auf Connections

    Klicke in der linken Seitenleiste unter AI auf Connections. Du solltest einen Abschnitt OpenAI API sehen.

    Klicke in der sich öffnenden Settings-Seite in der linken Seitenleiste unter AI auf Connections (rot umrandet)
  5. Füge eine Verbindung mit der URL und deinem API-Schlüssel hinzu

    Klicke im Abschnitt OpenAI API rechts auf +. Setze URL auf https://api.aicodewith.ai/v1, füge deinen API-Schlüssel ein (API-Schlüssel erhalten) und klicke auf Save.

    Klicke im Abschnitt OpenAI API rechts auf +, um Add Connection zu öffnen: Setze URL auf https://api.aicodewith.ai/v1, füge deinen API Key ein und klicke dann auf Save
  6. Prüfe, dass die Verbindung aktiviert ist

    Nach dem Speichern erscheint die Verbindung https://api.aicodewith.ai/v1 unter OpenAI API mit eingeschaltetem Schalter.

    Nach dem Speichern erscheint die Verbindung https://api.aicodewith.ai/v1 unter OpenAI API und ist aktiviert (roter Kasten)
  7. Möchtest du es noch einmal prüfen? Öffne die Verbindung

    Klicke auf das Zahnrad neben der Verbindung, um Edit Connection zu öffnen, und prüfe die URL. Der API-Schlüssel bleibt mit Punkten maskiert.

    Klicke auf das Zahnrad neben der Verbindung, um Edit Connection zu öffnen: URL ist https://api.aicodewith.ai/v1, und der API-Schlüssel darunter bleibt mit Punkten maskiert (Bearer)
  8. Wähle ein Modell in einem neuen Chat

    Starte einen neuen Chat und öffne die Modellauswahl. Wenn claude-haiku-4-5-20251001 und andere Modelle aufgelistet werden, stimmt die URL; ob der Schlüssel richtig ist, zeigt sich in Schritt 9, wenn du eine Antwort erhältst.

    Öffne die Modellauswahl; die von aicodewith bereitgestellten Modelle erscheinen, wobei claude-haiku-4-5-20251001 rot umrandet ist
  9. Sende eine Testnachricht

    Wähle claude-haiku-4-5-20251001 und sende Reply with exactly: Hello from aicodewith.ai. Eine Antwort Hello from aicodewith.ai bedeutet, dass du fertig bist.

    Wähle claude-haiku-4-5-20251001 und sende „Reply with exactly: Hello from aicodewith.ai“; das Modell antwortet Hello from aicodewith.ai (umrandet)
  10. Wie eine falsche URL aussieht: OpenAI: Network Problem

    Wenn die URL falsch ist (zum Beispiel https://api.aicodewith.ai/nope), zeigt ein Klick auf verify (Aktualisieren-Symbol) oben rechts OpenAI: Network Problem an. Siehe Häufige Fehler für die Lösung.

    Wenn die URL falsch ist (z. B. sie endet auf /nope), zeigt ein Klick auf verify (Aktualisieren-Symbol) den Toast "OpenAI: Network Problem" oben rechts an (umrandet)
  11. Setze die URL zurück auf /v1 und chatte erneut

    Setze die URL zurück auf https://api.aicodewith.ai/v1 und speichere. In einem neuen Chat bedeutet eine Antwort Hello from aicodewith.ai, dass es wieder funktioniert.

    Nachdem die URL auf https://api.aicodewith.ai/v1 zurückgesetzt und gespeichert wurde, antwortet ein neuer Chat erneut mit Hello from aicodewith.ai, was bestätigt, dass die Konfiguration wiederhergestellt ist

Häufige Fehler

OpenAI: Netzwerkproblem

Was du siehst

OpenAI: Network Problem
Ursache
Die Verbindungs-URL ist falsch (zum Beispiel https://api.aicodewith.ai/nope), daher kann Überprüfen (Aktualisieren-Symbol) keine Verbindung herstellen
So behebst du es
Setze die URL auf https://api.aicodewith.ai/v1 und speichere; ein neuer Chat antwortet dann normal

Zurück zu Schritt 5: Füge eine Verbindung mit der URL und deinem API-Schlüssel hinzu →

Wenn die URL falsch ist (z. B. sie endet auf /nope), zeigt ein Klick auf Überprüfen (Aktualisieren-Symbol) oben rechts den Toast "OpenAI: Network Problem" an (eingerahmt)

FAQ

Wie verwende ich meinen eigenen API-Schlüssel in Open WebUI?

Klicke im Admin-Panel → Einstellungen → Verbindungen im Bereich OpenAI API auf +, setze die URL auf https://api.aicodewith.ai/v1, füge deinen API-Schlüssel ein und speichere.

Muss ich den Open WebUI API-Schlüssel erneut eingeben?

Nein. Der Schlüssel wird in der eigenen Datenbank von Open WebUI gespeichert und übersteht einen Neustart, ohne dass eine Umgebungsvariable benötigt wird.

Wie prüfe ich die Open WebUI-Version?

open-webui hat keine --version-Option. Wenn du es mit uv installiert hast, führe uv tool list | grep open-webui aus.

Open WebUI meldet OpenAI: Network Problem. Was nun?

Die Verbindungs-URL ist falsch. Setze sie auf https://api.aicodewith.ai/v1 und speichere; siehe Häufige Fehler oben.

Quellen

Verwandte Links