DE ▾

Open WebUI OpenAI-kompatible API in 5 Minuten einrichten

Um die Open WebUI OpenAI-kompatible API einzurichten, fügst du eine Verbindung mit einer Basis-URL und einem Schlüssel hinzu, und das Modell erscheint im Auswahlfenster. Hier ist die genaue Einrichtung für Abliterated API, von Docker bis zum ersten Chat.

Aktualisiert

Chat-Schnittstelle, die durch ein leuchtendes Kabel mit einem gehosteten API-Server verbunden ist, repräsentiert eine Open WebUI-Verbindung

Wichtige Punkte

  • Die Basis-URL ist https://api.abliteratedapi.com/v1 und die Modell-ID ist uncensored.
  • Füge es in den Admin-Verbindungseinstellungen hinzu oder übergebe OPENAI_API_BASE_URL und OPENAI_API_KEY an Docker.
  • Teste den Schlüssel zuerst mit curl, damit du ein Schlüsselproblem von einem UI-Problem unterscheiden kannst.
  • Open WebUI ist nur das Frontend: Du zahlst pro Token für das, was das Modell liest und schreibt, und es wird keine Karte benötigt, um zu starten.

Die Kurzversion

Wenn du die Open WebUI OpenAI-kompatible API-Einrichtung in einem Absatz willst: Öffne die Admin-Einstellungen, füge eine OpenAI-API-Verbindung hinzu, stelle die URL auf https://api.abliteratedapi.com/v1, füge deinen Schlüssel ein, speichere und wähle das Modell namens uncensored. Das war's. Open WebUI kommuniziert mit allem, was das OpenAI-Chat-Vervollständigungsformat implementiert, und diese API tut das.

Der Dienst ist eine gehostete, OpenAI-kompatible Text-API, die ein Open-Weight-Modell betreibt, das darauf abgestimmt ist, ohne Inhaltsablehnungen für die rechtmäßige Nutzung durch Erwachsene zu antworten. Er wird von einem unabhängigen Anbieter betrieben und ist nicht die offizielle API eines Modell-Labors. Open WebUI ist nur das Chat-Frontend, auf das du die API richtest.

Bevor du beginnst

  • Ein API-Schlüssel. Erstelle einen auf der API-Schlüssel-Seite. Die Anmeldung erfolgt mit Google oder mit E-Mail und Passwort. Neue Nutzer können mit einem Klick auf dieser Seite $0,50 kostenloses Testguthaben beanspruchen, das 7 Tage gültig ist und keine Karte erfordert.
  • Ein laufendes Open WebUI. Eine Docker-Installation oder eine pip-Installation funktionieren beide. Die folgenden Schritte decken Docker und den Einstellungsbildschirm ab.
  • Netzwerkzugriff von der Maschine, auf der Open WebUI läuft, zu api.abliteratedapi.com über HTTPS.

Überprüfe den Schlüssel, bevor du die UI berührst. Wenn diese Abfrage eine Liste enthält, die uncensored enthält, sind Schlüssel und URL korrekt:

curl https://api.abliteratedapi.com/v1/models   -H "Authorization: Bearer $ABLITERATED_API_KEY"

Bestätige dann, dass eine echte Vervollständigung funktioniert:

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."}]}'

Methode 1: Verbindung in den Einstellungen hinzufügen

Dies ist der einfachste Weg und funktioniert auf einer bestehenden Installation. Menübeschriftungen bewegen sich zwischen Open WebUI-Versionen, daher können die Namen unten leicht abweichen.

  1. Melde dich als Admin in Open WebUI an und öffne das Admin-Panel, dann Einstellungen, dann Verbindungen.
  2. Finde den Abschnitt OpenAI API und füge eine neue Verbindung mit dem Plus-Button hinzu.
  3. Gib im URL-Feld https://api.abliteratedapi.com/v1 ein. Höre bei /v1 auf. Füge kein /chat/completions hinzu; Open WebUI hängt den Pfad selbst an.
  4. Füge deinen Schlüssel in das Schlüsselfeld ein. Er wird als Authorization: Bearer <key> gesendet.
  5. Verwende die Schaltfläche „Überprüfen“ neben den Feldern, wenn deine Version eine hat, und speichere dann.

Öffne einen neuen Chat und das Modellauswahlfenster. Das Modell uncensored sollte in der Liste sein, da Open WebUI es von GET /v1/models liest. Wenn die Liste leer bleibt, gehe zum Abschnitt zur Fehlerbehebung unten.

Methode 2: beim Start mit Docker einrichten

Gib bei einer Neuinstallation den Endpunkt als Umgebungsvariablen an. Open WebUI liest OPENAI_API_BASE_URL und OPENAI_API_KEY beim Start aus.

# 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

Besuche dann http://localhost:3000, erstelle das erste Konto (es wird zum Admin) und starte einen Chat. Das benannte Volumen behält deine Chats und Einstellungen bei, wenn du den Container aktualisierst.

Eines überrascht viele: Viele Open WebUI-Einstellungen werden nach dem ersten Start in der Datenbank gespeichert, und der gespeicherte Wert kann eine spätere Umgebungsvariable überschreiben. Wenn du den Schlüssel oder die URL in Docker änderst und sich nichts tut, ändere ihn stattdessen im Verbindungsbildschirm oder setze die gespeicherte Einstellung zurück.

Einstellungen, die sich lohnen anzupassen

Sobald das Chatten funktioniert, machen ein paar Optionen die Erfahrung besser und halten die Rechnung vorhersehbar.

Verwende das Kontextfenster sinnvoll

Das Kontextfenster hat 100.000 Token, die sich zwischen Prompt und Antwort teilen. Open WebUI sendet den Chatverlauf bei jeder Nachricht erneut, daher wird ein langer Chat mit jeder Runde teurer. Bei $0,15 pro 1M Input-Token kostet ein 20.000-Token-Verlauf $0,003 zum Senden, was billig ist, aber sich bei Tausenden von Nachrichten summiert. Starte einen neuen Chat für ein neues Thema.

Streaming und Sampling

Open WebUI streamt Antworten standardmäßig, und die API unterstützt Streaming über SSE. In den erweiterten Parametern kannst du Temperatur, top_p, Stop-Sequenzen, einen Seed für wiederholbare Ausgaben und die Strafen einstellen. Diese werden an das Modell weitergegeben. Lass max_tokens leer, es sei denn, du willst eine harte Grenze, da es optional ist.

Hintergrundaufgaben

Open WebUI kann im Hintergrund zusätzliche Modellaufrufe für Dinge wie das Benennen eines Chats ausführen. Jeder ist eine echte Anfrage auf deinem Guthaben und zählt zu den Limits. Wenn du Aufrufe bemerkst, die du nicht getippt hast, schau dir die Aufgabenmodell-Einstellungen an und weise sie einem Modell zu, für das du gerne zahlst, oder schalte die Helfer-Funktionen aus.

Voreinstellungen und System-Prompts

Open WebUI ermöglicht es dir, eine Modell-Voreinstellung in seinem Arbeitsbereich zu speichern: einen Namen, ein Basis-Modell, einen System-Prompt und Standardparameter. Erstelle eine auf Basis von uncensored für jede Aufgabe, die du oft ausführst, wie einen Bearbeitungshelfer, einen Code-Reviewer oder eine Figur für eine interaktive Fiktions-Sitzung. Ein kurzer System-Prompt, der die Rolle, den Ton und das Format der Antworten angibt, bringt mehr als lange Anweisungen, die in jeden Chat eingefügt werden.

Hier hilft das Profil des Modells. Es ist ein Open-Weight-Modell, das darauf abgestimmt ist, ohne Inhaltsablehnungen für die rechtmäßige Nutzung durch Erwachsene zu antworten, was sich für Fiction, Rollenspiel und Companion-Apps für Erwachsene eignet, wo eine Ablehnung mitten in einer Szene den Fluss unterbricht. Es ändert nicht die harte Grenze: keine sexuellen Inhalte mit Minderjährigen, niemals. Halte Voreinstellungen und gemeinsam genutzte Instanzen innerhalb dieser Regel und im Rahmen der Gesetze deines Wohnorts.

Wenn andere Personen deine Open WebUI-Instanz nutzen, denke daran, dass sie alle deinen Schlüssel und seine Limits teilen. Ein voller Schlüssel erlaubt 8 parallele Anfragen, daher ist eine Handvoll aktiver Nutzer in Ordnung, während eine große Gruppe, die gleichzeitig chattet, die Grenze erreichen kann. Jeder Person oder jedem Team ihren eigenen Schlüssel zu geben, verteilt die Last und macht das Guthaben einfacher zu verfolgen.

Was es kostet

Du zahlst nur für Token aus deinem Prepaid-Guthaben: $0,15 pro 1 Mio. Input-Token und $0,50 pro 1 Mio. Output-Token. Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet und das Guthaben verfällt nie. Eine typische Chat-Nachricht mit 3.000 Token Verlauf und einer 400-Token-Antwort kostet $0,00045 + $0,0002 = $0,00065, also entspricht $10 Nutzung etwa 15.000 Nachrichten.

Aufladungen liegen zwischen $20 und $500 in beliebigen ganzen Beträgen, mit +5% ab $50, +10% ab $100 und +15% ab $200. Du kannst mit Krypto (USDT auf TRC20, USDC auf Base) bezahlen. Siehe die Preisseite für die Details. Der verbleibende Saldo wird im X-Balance-USD-Header jeder API-Antwort zurückgegeben, falls du ihn über ein Skript überwachen möchtest.

Fehlerbehebung

SymptomWahrscheinliche UrsacheLösung
Modellliste ist leerFalsche URL oder SchlüsselFühre den curl-Test für /v1/models durch. Die URL muss mit /v1 enden.
Verbindung abgelehnt oder Timeout von DockerKein ausgehender HTTPS aus dem ContainerÜberprüfe DNS-, Proxy- und Firewall-Einstellungen auf dem Host.
Auth-Fehler bei jeder NachrichtSchlüssel mit Leerzeichen eingefügt oder alter SchlüsselKopiere den Schlüssel erneut von der Schlüssel-Seite und speichere ihn ab.
Fehler, wenn mehrere Personen gleichzeitig chattenRatenlimitsEin voller Schlüssel erlaubt 8 parallele Anfragen und 300 pro Minute; ein Trial-Key erlaubt 2 und 60.
Langes Chatten funktioniert nicht mehrKontextfenster vollDas Fenster hat 100.000 Token. Starte einen neuen Chat oder fasse zusammen.

Wenn der curl-Test besteht, Open WebUI aber fehlschlägt, liegt das Problem in den Frontend-Einstellungen. Wenn curl fehlschlägt, überprüfe zuerst deinen Schlüssel und Saldo. Die Schnellstartanleitung der Dokumentation listet jeden Anfrageparameter auf, und der Artikel zu was die unzensierte Chat-API ist und nicht ist erklärt den Umfang des Modells, einschließlich der harten Grenze: keine sexuellen Inhalte mit Minderjährigen.

Fragen und Antworten

Welche URL gebe ich in Open WebUI ein?

Verwende https://api.abliteratedapi.com/v1 und nichts danach. Open WebUI fügt /chat/completions und /models selbst hinzu.

Welchen Modellnamen wähle ich?

Die Modell-ID ist uncensored. Sie erscheint im Modell-Auswahlfeld, sobald die Verbindung gespeichert ist und die Modellliste geladen wurde.

Brauche ich eine Karte zum Ausprobieren?

Nein. Neue Nutzer können nach der Registrierung mit einem Klick auf der API-Schlüssel-Seite $0,50 kostenloses Testguthaben beanspruchen. Es gilt 7 Tage lang und erfordert keine Kreditkarte.

Kann ich es neben lokalen Modellen betreiben?

Ja. Open WebUI unterstützt mehrere Verbindungen gleichzeitig, sodass dieser Endpunkt neben lokalen Modellen liegen kann und jeder in derselben Modellauswahl erscheint.

Werden meine Chats zum Training verwendet?

Nein. An die API gesendete Prompts werden nicht zum Training verwendet. Der von Open WebUI gespeicherte Chatverlauf bleibt in deiner eigenen Installation.

Dein Schlüssel ist nur ein Formular entfernt

Erstelle ein Konto, kopiere den Schlüssel, ändere die Basis-URL. Das ist die gesamte Einrichtung.

API-Schlüssel erhalten