---
title: "Open WebUI: eigenen OpenAI-kompatiblen Endpoint einrichten"
description: "BroadNet Inference in Open WebUI als OpenAI-kompatible Verbindung hinzufügen, Modell-IDs in die Allowlist eintragen, Verify-, Leer- und 429-Fehler beheben."
url: https://broadrouter.com/de/guides/open-webui-openai-api/
lang: de
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Mit KI-Unterstützung aus dem Englischen übersetzt. [Englisches Original lesen](https://broadrouter.com/guides/open-webui-openai-api/) (aktualisiert am 2026-11-16).

# Open WebUI mit BroadNet Inference verbinden

Aktualisiert 2026-11-16

Öffnen Sie in Open WebUI im Admin-Bereich Settings > Connections, klicken Sie unter Manage OpenAI API Connections auf Add Connection, setzen Sie URL auf https://inference.broadnet.ai/v1 und API Key auf Ihren BroadNet-Schlüssel. Tragen Sie dann Modell-IDs wie broadnet/glm-5.3 in die Allowlist Model IDs ein und speichern Sie.

Open WebUI ist eine selbst gehostete Chat-Oberfläche. Sie verbindet sich mit jedem Anbieter, der das Chat-Completions-Protokoll von OpenAI implementiert, und BroadNet Inference tut das. Die Schritte folgen [der Anleitung von Open WebUI für OpenAI-kompatible Anbieter](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible).

## Einrichtung

1.  **BroadNet-Schlüssel besorgen.** Für eine Chat-Oberfläche, die mehrere Personen nutzen, passt ein Pay-as-you-go-Schlüssel. Siehe [API-Schlüssel und IP-Allowlists](https://broadrouter.com/de/guides/api-keys-ip-allow-lists/).
    
2.  **Verbindungsseite öffnen.** Gehen Sie im Admin-Bereich zu **Settings > Connections** und suchen Sie **Manage OpenAI API Connections**.
    
3.  **Klicken Sie auf Add Connection** und füllen Sie aus:
    
    | Feld | Wert |
    | --- | --- |
    | URL | `https://inference.broadnet.ai/v1` (ohne Schrägstrich am Ende) |
    | API Key | Ihr BroadNet-Schlüssel |
    | Model IDs | jede ID unten einzeln über das Symbol **+** hinzufügen |
    
4.  **Modell-IDs von Hand hinzufügen.** Tippen Sie `broadnet/glm-5.3`, klicken Sie auf **+** und wiederholen Sie das für die anderen gewünschten Modelle. Die BroadNet-Dokumentation beschreibt `GET /v1/models` als öffentliche Katalog-Metadaten für Monitoring; verlassen Sie sich also nicht darauf, dass die Modellauswahl damit gefüllt wird.
    
5.  **Klicken Sie auf Save.** Laut Dokumentation von Open WebUI testet das Speichern die Verbindung nicht.
    
6.  **Starten Sie einen Chat** und wählen Sie das Modell in der Modellauswahl.
    

### Mit Umgebungsvariablen

Wenn Sie Open WebUI in Docker betreiben, können Sie die Verbindung beim Start setzen:

```bash
OPENAI_API_BASE_URL=https://inference.broadnet.ai/v1
OPENAI_API_KEY=your-broadnet-key
```

Um BroadNet neben einer bestehenden OpenAI-Verbindung hinzuzufügen, nutzen Sie die Pluralformen, getrennt durch Semikolons: `OPENAI_API_BASE_URLS` und `OPENAI_API_KEYS`. `OPENAI_API_CONFIGS` setzt Optionen pro Verbindung wie `model_ids`, adressiert über den Index der Verbindung in dieser Liste:

```bash
OPENAI_API_CONFIGS='{"0": {"enable": true, "model_ids": ["broadnet/glm-5.3", "broadnet/qwen3.8-27b"]}}'
```

Die [Referenz der Umgebungsvariablen](https://docs.openwebui.com/reference/env-configuration) von Open WebUI kennzeichnet diese als ConfigVar-Einstellungen. Sie werden beim ersten Start gelesen und in der Datenbank gespeichert. Danach gilt, was im Admin-Panel steht. Bearbeiten Sie die Verbindung im Admin-Bereich unter **Settings > Connections** oder setzen Sie `ENABLE_PERSISTENT_CONFIG=False`, wenn die Umgebung bei jedem Start gelten soll.

## Welches Modell passt?

| Einsatz | Modell | Kontext |
| --- | --- | --- |
| Allgemeiner Chat, Tools, JSON | `broadnet/glm-5.3` | 1.048.576 |
| Fragen zu Bildern, Arabisch | `broadnet/qwen3.8-27b` | 262.144 |
| Lange Dokumente, Bilder | `broadnet/deepseek-v4.1-flash` | 1.048.576 |
| Günstig, kostenloses Guthaben | `broadnet/gemma-4-26b-a4b` | 32.768 |

BroadNet hat Qwen3.8 27B auf Arabisch getestet, auch mit Golf-Arabisch und Ägyptisch; siehe [ein LLM für Arabisch auswählen](https://broadrouter.com/de/blog/choosing-an-llm-for-arabic/). Gemma 4 VL 26B ist das einzige Chatmodell, das mit dem Startguthaben von $5 funktioniert; das Guthaben deckt außerdem die beiden Transcribe-Modelle ab. Die Preise stehen auf der [Preisseite](https://broadrouter.com/de/pricing/).

Open WebUI übergibt Standardparameter wie `temperature` und `max_tokens` und unterstützt Tool-Nutzung, wenn Modell und Server `tools` unterstützen. BroadNet nennt Tools für GLM 5.3 und Qwen3.8 27B.

## Fehlerbehebung

-   **Verify Connection schlägt mit 400, 401 oder 403 fehl.** Der Verify-Button von Open WebUI ruft `/models` auf. Laut Dokumentation können Chat Completions trotzdem funktionieren. Tragen Sie die IDs in die Allowlist ein und testen Sie einen Chat. Liefert auch der Chat 401, ist der Schlüssel falsch, abgelaufen oder das Pay-as-you-go-Kontingent ist aufgebraucht.
-   **Das Modell ist gelistet, aber die erste Nachricht schlägt fehl.** Prüfen Sie, ob die ID exakt der von BroadNet entspricht, mit dem Präfix `broadnet/`. GLM 5.3, Qwen3.8 27B und DeepSeek V4.1 Flash brauchen eine Aufladung.
-   **Leere Antworten.** Reasoning-Modelle (DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B) verbrauchen zuerst Output-Tokens fürs Reasoning. Wenn Sie **max\_tokens** in den **Advanced Params** des Modells gesetzt haben, erhöhen oder leeren Sie den Wert. [Warum Antworten leer zurückkommen](https://broadrouter.com/de/guides/reasoning-tokens-empty-response/).
-   **429, wenn mehrere Personen chatten.** Ein Pay-as-you-go-Schlüssel erlaubt 30 Anfragen pro Minute und 4 gleichzeitig. Open WebUI macht außerdem Hintergrundaufrufe mit demselben Schlüssel, etwa für Chat-Titel. Siehe [Fehlercodes und Retries](https://broadrouter.com/de/guides/errors-and-retries/).
-   **Geänderte Umgebungsvariablen bewirken nichts.** Der erste Start hat die alten Werte gespeichert. Bearbeiten Sie die Verbindung im Admin-Panel oder lesen Sie den Abschnitt zu Umgebungsvariablen oben.
-   **Mit einem Plan-Schlüssel.** Eine [Session eines unbegrenzten Plans](https://broadrouter.com/de/guides/unlimited-llm-api-sessions/) verarbeitet immer nur eine Anfrage, und Schlüssel dürfen nicht geteilt werden. Das passt zu einer Instanz, die eine Person allein nutzt; Anfragen weiterer Nutzer landen in der Warteschlange.

## Begriffe in dieser Anleitung

[Tool Calling (Function Calling)](https://broadrouter.com/de/glossary/tool-calling/)

Tool Calling, auch Function Calling genannt, ist eine Funktion von LLM-APIs, bei der das Modell eine strukturierte Anfrage zurückgibt, eine vom Entwickler definierte Funktion mit JSON-Argumenten auszuführen. Die Anwendung führt die Funktion aus und sendet das Ergebnis zurück; das Modell selbst führt nie Code aus.

[Token](https://broadrouter.com/de/glossary/token/)

Ein Token ist die Texteinheit, die ein Sprachmodell liest und schreibt: ein Wort, ein Wortteil, ein Satzzeichen oder eine Bytefolge, die der Tokenizer des Modells erzeugt. LLM-APIs zählen, begrenzen und berechnen die Nutzung meist in Tokens.

[API-Schlüssel (API Key)](https://broadrouter.com/de/glossary/api-key/)

Ein API-Schlüssel ist eine geheime Zeichenfolge, die einen Client beim Aufruf einer API identifiziert und autorisiert. LLM-APIs erwarten ihn meist im Header Authorization: Bearer, und wer den Schlüssel besitzt, kann Anfragen stellen, die dem Konto des Inhabers berechnet werden.

[Pay-as-you-go](https://broadrouter.com/de/glossary/pay-as-you-go/)

Pay-as-you-go ist ein Preismodell, bei dem Sie nur für tatsächliche Nutzung zahlen, gemessen pro Einheit wie Tokens, Anfragen oder Audiominuten, ohne Abonnement oder Mindestabnahme. Die meisten LLM-APIs rechnen so ab, aus einem vorausbezahlten Guthaben oder per regelmäßiger Rechnung.

[Rate Limit (Ratenbegrenzung)](https://broadrouter.com/de/glossary/rate-limit/)

Ein Rate Limit ist eine Obergrenze, die eine API festlegt, wie stark ein Client sie in einem Zeitfenster nutzen darf, etwa Anfragen pro Minute oder Tokens pro Minute. Anfragen über dem Limit werden abgelehnt, meist mit HTTP 429 Too Many Requests, bis die Nutzung wieder darunter liegt.

[Arabische Dialekte (Dialectal Arabic)](https://broadrouter.com/de/glossary/dialectal-arabic/)

Dialektales Arabisch ist das gesprochene Alltagsarabisch einer Region oder Stadt, etwa Ägyptisch, Golf-Arabisch, Levantinisch oder Maghrebinisch. Dialekte unterscheiden sich vom modernen Hocharabisch in Lauten, Wörtern und Grammatik, haben keine Standardschreibung und werden online zunehmend geschrieben, was sie für Sprachmodelle schwieriger macht.

[Chat Completions API](https://broadrouter.com/de/glossary/chat-completions-api/)

Die Chat Completions API ist der HTTP-Endpoint von OpenAI, POST /v1/chat/completions, der einen Modellnamen und eine Liste von Nachrichten mit Rollen entgegennimmt und die nächste Nachricht des Modells zurückgibt. Ihr Format für Anfrage und Antwort wurde zum gemeinsamen Standard, den OpenAI-kompatible Anbieter und SDKs übernehmen.

[Concurrency (Parallelität)](https://broadrouter.com/de/glossary/concurrency/)

Concurrency (Parallelität) ist die Zahl der Anfragen, die ein Client gleichzeitig offen hat. LLM-APIs begrenzen sie oft pro Schlüssel oder Plan, getrennt von den Anfragen pro Minute, weil jede offene Anfrage GPU-Kapazität belegt, bis ihre Antwort fertig ist.

## Häufige Fragen

### Warum schlägt Verify Connection fehl, obwohl der Chat funktioniert?

Der Verify-Button von Open WebUI ruft den /models-Endpoint des Anbieters auf. Laut Dokumentation heißt ein fehlgeschlagener Test nicht, dass der Chat kaputt ist. Tragen Sie die BroadNet-Modell-IDs von Hand in die Allowlist Model IDs ein.

### Kann ich die Verbindung über Umgebungsvariablen setzen?

Ja. Setzen Sie OPENAI\_API\_BASE\_URL auf https://inference.broadnet.ai/v1 und OPENAI\_API\_KEY auf Ihren BroadNet-Schlüssel. Open WebUI speichert diese Werte beim ersten Start; spätere Änderungen an den Variablen werden ignoriert, außer ENABLE\_PERSISTENT\_CONFIG steht auf False.

### Warum wirkt mein neuer Wert für OPENAI\_API\_BASE\_URL nicht?

Open WebUI behandelt ihn als ConfigVar. Nach dem ersten Start nutzt es den Wert, der in seiner Datenbank gespeichert ist. Ändern Sie die URL im Admin-Bereich unter Settings > Connections oder setzen Sie ENABLE\_PERSISTENT\_CONFIG=False, damit die Umgebung bei jedem Start gelesen wird.

### Kann mein ganzes Team in Open WebUI einen Schlüssel eines unbegrenzten Plans teilen?

Nein. Die Pläne von BroadNet erlauben es nicht, einen Schlüssel zu teilen, und eine Plan-Session verarbeitet immer nur eine Anfrage. Nutzen Sie für ein gemeinsames Open WebUI einen Pay-as-you-go-Schlüssel.

## Verwandte Anleitungen

-   [BroadNet Inference als Custom Endpoint in LibreChat einbinden](https://broadrouter.com/de/guides/librechat-custom-endpoint/)
-   [Warum ein Reasoning-Modell eine leere Antwort liefert](https://broadrouter.com/de/guides/reasoning-tokens-empty-response/)
-   [So funktionieren die unbegrenzten LLM-API-Pläne für Agenten](https://broadrouter.com/de/guides/unlimited-llm-api-sessions/)
-   [Fehlercodes von BroadNet Inference: Wann ist ein Retry sinnvoll?](https://broadrouter.com/de/guides/errors-and-retries/)
-   [Alle Tools, die mit BroadNet Inference funktionieren (auf Englisch)](https://broadrouter.com/integrations/): SDKs, Coding-Agenten, Chat-Oberflächen und Automatisierungstools, jeweils mit den genauen Einstellungen

Testen Sie es mit Ihrem echten Workload. Neue Konten starten mit USD 5 Guthaben für Gemma und Transkription. DeepSeek, GLM und Qwen3.8 erfordern eine Aufladung.

[Loslegen](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-open-webui-openai-api&utm_content=page-cta) ·

**Quellen**

-   [Open-WebUI-Dokumentation, OpenAI-kompatible Anbieter (geprüft am 2026-11-16)](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible)
-   [Open-WebUI-Dokumentation, Konfiguration über Umgebungsvariablen (geprüft am 2026-11-14)](https://docs.openwebui.com/reference/env-configuration)
-   [API-Referenz von BroadNet Inference (auf Englisch)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-open-webui-openai-api&utm_content=sources)
