Hat OpenWebUI eine API? Ja, in zwei Richtungen

Zwei verschiedene APIs, die gemeint sind

Wenn jemand fragt, ob Open WebUI eine API hat, kann er sich auf eine von zwei Richtungen beziehen. Diese zu vermischen ist der Hauptgrund, warum Einrichtungsanleitungen verwirrend wirken. Es hilft also, sie zunächst zu trennen.

• Inbound: Dein Programm sendet Anfragen an Open WebUI. Es fungiert als Server mit Endpunkten für Chat, Modelle und Dateien, geschützt durch einen API-Schlüssel, den du in der App generierst.
• Outbound: Open WebUI sendet Anfragen an einen Modell-Server, damit sein Chat-Fenster etwas zu sagen hat. Dies ist die Verbindung, die du unter Admin-Einstellungen konfigurierst.

Die kurze Antwort lautet also: Ja für beide. Das Projekt dokumentiert eine API mit einem OpenAI-ähnlichen Chat-Endpunkt und unterstützt die Verbindung zu jedem Server, der das OpenAI-Protokoll spricht. Details wie genaue Pfade und Schlüsselverwaltung können sich zwischen Versionen ändern, also prüfe die Dokumentation für die von dir genutzte Version.

Diese Seite stellt das Modell auf der Ausgabeseite bereit: eine gehostete, im OpenAI-Stil gehaltene Text-API mit der einzigen Modell-ID uncensored. Es ist nicht Open WebUI und führt es nicht für dich aus. Open WebUI ist Software, die du selbst hostest.

Nutzung der eigenen API von Open WebUI

Open WebUI ermöglicht es einem angemeldeten Benutzer, einen API-Schlüssel in seinen Kontoeinstellungen zu erstellen. Mit diesem Schlüssel kannst du seine Endpunkte aus Skripten aufrufen. Der Chat-Endpunkt folgt der OpenAI-Struktur, sodass bestehender Client-Code oft darauf zeigen kann. Der vom Projekt zum Zeitpunkt des Schreibens dokumentierte Pfad ist /api/chat/completions; bestätige dies mit deiner Version.

Copy# Open WebUI running locally on port 3000, key created in Settings > Account
curl http://localhost:3000/api/chat/completions \
  -H "Authorization: Bearer $OPENWEBUI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Summarize this scene in one line."}]}'

Beachte, dass hier der Modellname derjenige ist, den Open WebUI registriert hat. Wenn du diese API als Backend verbunden hast, ist dieser Name uncensored. Der Schlüssel in dieser Anfrage ist ein Open WebUI-Schlüssel, nicht der Modell-API-Schlüssel. Es sind zwei separate Anmeldeinformationen mit zwei separaten Aufgaben.

Warum die Inbound-API nutzen? Sie ist nützlich, wenn du die Extras von Open WebUI hinter deinem Programm möchtest, wie seine gespeicherten Wissenssammlungen, seine benutzerspezifischen Konten oder seine Modell-Voreinstellungen, und du darauf ohne Browser zugreifen möchtest.

Nutzung einer externen API als Backend

Die andere Richtung ist die, die die meisten Leute benötigen. Open WebUI hat einen Bereich für OpenAI-kompatible Verbindungen, in dem du eine URL und einen Schlüssel eingibst. Für diesen Dienst lauten die Werte:

• URL: https://api.nsfwvideo.top/v1
• Schlüssel: der von der Schlüssel-Seite
• Modell: uncensored, automatisch entdeckt über GET /v1/models

Schritt für Schritt: Öffne Admin-Einstellungen, gehe zu Verbindungen, füge eine OpenAI-API-Verbindung hinzu, füge die URL und den Schlüssel ein, speichere und wähle das Modell in einem neuen Chat. Wenn du einen Start über die Kommandozeile bevorzugst, setze die Umgebungsvariablen OPENAI_API_BASE_URL und OPENAI_API_KEY beim Starten des Containers.

Copydocker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.nsfwvideo.top/v1 \
  -e OPENAI_API_KEY=$API_KEY \
  -v open-webui:/app/backend/data \
  ghcr.io/open-webui/open-webui:main

Achte darauf, dass Open WebUI viele Einstellungen bei der ersten Start in die Datenbank speichert. Wenn du später eine Umgebungsvariable änderst und sich nichts ändert, bearbeite die Verbindung stattdessen im Admin-Bereich. Der Quickstart enthält das Anfrageformat, das das Backend erwartet, falls du es mit curl überprüfen möchtest.

Kombination beider

Du kannst beide Richtungen gleichzeitig nutzen. Deine Anwendung ruft die eingehende API von Open WebUI mit einem Open WebUI-Schlüssel auf, Open WebUI leitet den Chat an das von dir konfigurierte Backend weiter, und die Antwort fließt zurück. Diese Anordnung macht in einigen Situationen Sinn: Ein Team betreibt bereits Open WebUI mit Konten und möchte Skripte, die seine Voreinstellungen nutzen, oder du möchtest einen Ort, der Persona-Einstellungen sowohl für Menschen als auch für Programme enthält.

Es fügt einen Zwischenschritt hinzu. Jede Anfrage durchläuft nun deinen Open WebUI-Server, bevor sie die Modell-API erreicht, also gibt es ein weiteres Element, das am Laufen gehalten, gepatcht und gesichert werden muss. Ratenlimits stapeln sich auch auf eine unklare Weise: Der Backend-Schlüssel erlaubt 8 parallele Anfragen und 300 pro Minute für einen vollständigen Schlüssel, und jeder Benutzer und jedes Skript, das über deine Open WebUI-Instanz läuft, teilt sich dieses Kontingent. Wenn das Backend mit HTTP 429 antwortet, mit dem Fehlercode rate_limited oder concurrency, tritt der Fehler normalerweise als Fehler in Open WebUI und bei deinem Aufrufer auf.

Wann Open WebUI überspringen und direkt die API aufrufen

Wenn du nur ein Skript benötigst, das Text generiert, wie Entwürfe, Kameravorschläge oder erste Erzählungen, ist Open WebUI unnötig. Dieser Dienst ist ein normaler Endpunkt im OpenAI-Stil, sodass das Standard-SDK direkt damit kommuniziert.

Copyimport os
from openai import OpenAI

client = OpenAI(base_url="https://api.nsfwvideo.top/v1", api_key=os.environ["API_KEY"])

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You write concise shot lists for short films."},
        {"role": "user", "content": "Shot list for a ninety second chase through a night market."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)

Direkte Aufrufe bieten dir Streaming über SSE, Function Calling, JSON-Modus und alle Sampling-Parameter ohne Zwischenschicht. Open WebUI ist die bessere Wahl, wenn du eine Chat-Oberfläche für Nutzer mit Verlauf, Konten und Voreinstellungen möchtest. Ein Skript ist die bessere Wahl für Batch-Arbeit. Die API erzeugt nur Text: Sie rendert kein Video, keine Bilder oder Audio, also liefert sie für ein Video-Projekt die geschriebenen Teile wie Skripte und Prompts für andere Tools. Die Video-Pipeline-Seite geht auf diesen Anwendungsfall ein.

Ein schneller Entscheidungsleitfaden

• Du möchtest ein Chat-Fenster für dich oder ein Team: führe Open WebUI aus und füge die Outbound-Verbindung hinzu.
• Du möchtest Skripte, die Open WebUI-Voreinstellungen oder Konten wiederverwenden: nutze deren eingehende API mit einem Open WebUI-Schlüssel.
• Du möchtest Batch-Textgenerierung: rufe die Modell-API direkt mit dem OpenAI SDK auf und überspringe die zusätzliche Schicht.
• Du möchtest Bilder oder Stimme: weder Open WebUI noch diese Text-API werden sie allein erzeugen. Verbinde separate Tools für diesen Schritt.

Welchen Pfad du auch wählst, die modellseitigen Fakten bleiben gleich: ein Kontextfenster mit 100.000 Token, das von Prompt und Antwort geteilt wird, Function Calling und JSON-Modus verfügbar, und eine harte Regel gegen sexuelle Inhalte, die Minderjährige betreffen.

Sicherheitshinweise zum Freigeben einer der APIs

Behandle beide Schlüssel als Geheimnisse. Der Open WebUI-Schlüssel gewährt, was der erstellende Benutzer in deiner Instanz tun kann; der Modell-API-Schlüssel verbraucht dein Prepaid-Guthaben. Füge keines von beiden in Client-Code oder öffentliche Repositories ein.

• Setze Open WebUI hinter HTTPS, wenn es über deine eigene Maschine hinaus erreichbar ist.
• Erstelle separate Open WebUI-Schlüssel pro Skript, damit du einen widerrufen kannst, ohne die anderen zu beeinträchtigen.
• Rotiere den Modell-API-Schlüssel, wenn er jemals in einem Protokoll oder einem Screenshot erscheint.
• Beobachte den X-Balance-USD-Antwortheader auf dem Backend, um die Ausgaben pro Aufruf zu sehen.

Bezüglich Datenschutz: Prompts, die an diese API gesendet werden, werden nicht zum Training verwendet. Open WebUI selbst speichert den Chat-Verlauf in seiner eigenen Datenbank auf deinem Server, also bestimmen deine Hosting-Entscheidungen, wer das lesen kann.

Was es kostet, dieses Setup zu betreiben

Open WebUI ist kostenlose Software, die du hostest; deine Kosten sind der Server plus die Token. Token werden mit $0,15 pro 1M Input und $0,50 pro 1M Output abgerechnet, vom Prepaid-Guthaben ohne Abonnement. Mache einen Chat-Turn mit 3.000 Input-Token und 500 Output-Token: 3.000 x $0,15 / 1M = $0,00045 für Input und 500 x $0,50 / 1M = $0,00025 für Output, insgesamt $0,0007. Tausend solcher Turns kosten $0,70.

Aufladungen sind beliebige ganze Beträge von 20 $ bis 500 $, mit +5 % ab 50 $, +10 % ab 100 $ und +15 % ab 200 $. Die Zahlung erfolgt per Krypto, USDT auf TRC20 oder USDC auf Base. Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, und Guthaben verfällt nie. Neue Nutzer können mit einem Klick und ohne Zahlungsdaten ein 0,50 $-Testguthaben für 7 Tage beanspruchen. Sieh dir die Preise für das vollständige Bild an.

Eine Erinnerung an den Inhalt: Das Modell ist darauf abgestimmt, ohne Inhaltsfilter für die rechtmäßige Erwachsenennutzung zu antworten, und sexuelle Inhalte, die Minderjährige betreffen, sind niemals erlaubt.

Weitere Anleitungen

• Unzensierte LLM-API für NSFW-Video-Pipelines