---
title: "LibreChat: Custom Endpoint in librechat.yaml (OpenAI-API)"
description: "BroadNet Inference als OpenAI-kompatiblen Custom Endpoint in librechat.yaml einrichten: Schlüssel in .env, Modellliste, Titelmodell und Fehlerbehebung."
url: https://broadrouter.com/de/guides/librechat-custom-endpoint/
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/librechat-custom-endpoint/) (aktualisiert am 2026-11-16).

# BroadNet Inference als Custom Endpoint in LibreChat einbinden

Aktualisiert 2026-11-16

Legen Sie in librechat.yaml unter endpoints.custom einen Eintrag an: name BroadNet, apiKey als Verweis auf eine Umgebungsvariable wie BROADNET\_API\_KEY, baseURL https://inference.broadnet.ai/v1 und unter models.default BroadNet-IDs wie broadnet/glm-5.3. Tragen Sie den Schlüssel in .env ein, mounten Sie die Datei unter Docker in den Container und starten Sie LibreChat neu. LibreChat hängt /chat/completions selbst an die Basis-URL an.

LibreChat ist eine quelloffene Chat-App, die OpenAI-kompatible Dienste als **Custom Endpoints** unterstützt. Sie definieren sie in `librechat.yaml`, legen die Schlüssel in `.env` ab und mounten die YAML-Datei unter Docker in den Container. BroadRouter ist die Website von BroadNet selbst; die Schritte folgen dem [Leitfaden zu Custom Endpoints von LibreChat](https://www.librechat.ai/docs/quick_start/custom_endpoints).

## Einrichtung

1.  **librechat.yaml mounten (nur Docker).** Kopieren Sie `docker-compose.override.yml.example` nach `docker-compose.override.yml` und stellen Sie sicher, dass das Volume aktiv ist:

```yaml
services:
  api:
    volumes:
      - type: bind
        source: ./librechat.yaml
        target: /app/librechat.yaml
```

2.  **Endpoint hinzufügen** – in `librechat.yaml` im Projektstamm, unter `endpoints.custom`:

```yaml
endpoints:
  custom:
    - name: 'BroadNet'
      apiKey: '${BROADNET_API_KEY}'
      baseURL: 'https://inference.broadnet.ai/v1'
      models:
        default:
          - 'broadnet/glm-5.3'
          - 'broadnet/qwen3.8-27b'
          - 'broadnet/deepseek-v4.1-flash'
          - 'broadnet/gemma-4-26b-a4b'
        fetch: false
      titleConvo: true
      titleModel: 'broadnet/gemma-4-26b-a4b'
      modelDisplayLabel: 'BroadNet'
```

Behalten Sie vorhandene Top-Level-Schlüssel Ihrer Datei bei, etwa `version`.

3.  **Schlüssel setzen** in `.env`:

```bash
BROADNET_API_KEY=your-broadnet-key
```

4.  **LibreChat neu starten.** Mit Docker: `docker compose down && docker compose up -d`. Bei einer lokalen Installation starten Sie mit `npm run backend` neu. Danach erscheint BroadNet in der Endpoint-Auswahl.

## Hinweise zu den Feldern

-   **baseURL.** LibreChat hängt `/chat/completions` selbst an; nutzen Sie also den `/v1`\-Stamm von oben. Setzen Sie nicht `directEndpoint: true` – diese Option ist für eine baseURL gedacht, die bereits die vollständige Completions-URL ist.
-   **fetch: false.** Das ist der Standard von LibreChat; wir setzen es, damit die Wahl sichtbar ist. Die BroadNet-Dokumentation beschreibt `GET /v1/models` als öffentliche Katalog-Metadaten für Monitore, daher ist eine Modellliste in `default` berechenbarer.
-   **titleModel.** LibreChat erzeugt für jeden Chat mit einer zusätzlichen Anfrage einen Titel. Ein kleines, günstiges Modell ohne Reasoning hält diesen Aufruf kurz. Die BroadNet-Dokumentation nennt für Gemma 4 VL 26B kein Reasoning.
-   **user\_provided.** Setzen Sie `apiKey: 'user_provided'`, wenn jeder Nutzer seinen eigenen BroadNet-Schlüssel in der Oberfläche eingeben soll. LibreChat speichert den Schlüssel jedes Nutzers verschlüsselt und fragt ihn ab, sobald der Endpoint zum ersten Mal gewählt wird.
-   **Eindeutiger Name.** Ein zweiter Endpoint mit demselben Namen (ohne Rücksicht auf Groß-/Kleinschreibung) ersetzt den ersten stillschweigend. Haben Sie schon einen Eintrag namens BroadNet, benennen Sie einen um.
-   **Keine Schlüssel im Klartext.** Die LibreChat-Dokumentation empfiehlt den Verweis `${VAR}` statt eines in `librechat.yaml` eingetippten Schlüssels, der sonst im Klartext in der Datei stünde.

## Welches Modell passt?

| Einsatz | Modell |
| --- | --- |
| Standard-Chat, Tools, JSON | [GLM 5.3](https://broadrouter.com/de/models/glm-5.3/) |
| Bilder und Arabisch | [Qwen3.8 27B](https://broadrouter.com/de/models/qwen3.8-27b/) |
| Lange Dokumente, 1M Kontext | [DeepSeek V4.1 Flash](https://broadrouter.com/de/models/deepseek-v4.1-flash/) |
| Titel und schnelle Antworten | [BroadNet Gemma 4 VL 26B](https://broadrouter.com/de/models/gemma-4-vl-26b/) |

Von diesen Modellen läuft nur Gemma 4 VL 26B mit dem Startguthaben von $5, das außerdem die beiden Transcribe-Modelle abdeckt. Preise vergleichen Sie auf der [Preisseite](https://broadrouter.com/de/pricing/).

## Fehlerbehebung

-   **Der Endpoint erscheint nicht.** Prüfen Sie, ob `name`, `baseURL`, `apiKey` und `models.default` richtig geschrieben und innerhalb von `endpoints.custom` eingerückt sind. LibreChat verwirft unvollständige Einträge ohne Logzeile. Prüfen Sie unter Docker, ob der Bind-Mount in `docker-compose.override.yml` nicht mehr auskommentiert ist.
-   **„Missing API Key for BroadNet“.** `BROADNET_API_KEY` fehlt in `.env`, oder LibreChat wurde nicht neu gestartet. Der Endpoint erscheint trotzdem; der Fehler zeigt sich erst beim Senden einer Nachricht.
-   **401 vom Provider.** Der Schlüssel ist falsch oder abgelaufen, oder das Pay-as-you-go-Kontingent ist aufgebraucht.
-   **Modellfehler.** Jede ID muss exakt der BroadNet-ID entsprechen, mit dem Präfix `broadnet/`. GLM 5.3, Qwen3.8 27B und DeepSeek V4.1 Flash brauchen eine Aufladung.
-   **Leere Antworten.** DeepSeek V4.1 Flash, GLM 5.3 und Qwen3.8 27B denken zuerst nach, und das Reasoning zählt zu `max_tokens`. Haben Sie in den Parametern von LibreChat eine kleine maximale Ausgabe gesetzt, erhöhen Sie sie. [Warum Antworten leer zurückkommen](https://broadrouter.com/de/guides/reasoning-tokens-empty-response/).
-   **429 bei vielen Nutzern.** Ein Pay-as-you-go-Schlüssel erlaubt 30 Anfragen pro Minute und 4 gleichzeitig, geteilt von allen Nutzern des Endpoints. Titelanfragen zählen mit. Mit `user_provided`\-Schlüsseln verteilt sich die Last. Siehe [Fehlercodes und Retries](https://broadrouter.com/de/guides/errors-and-retries/).
-   **Plan-Schlüssel.** Eine [Session eines unbegrenzten Plans](https://broadrouter.com/de/guides/unlimited-llm-api-sessions/) verarbeitet eine Anfrage nach der anderen und lässt sich nicht teilen; sie passt also nicht zu einem LibreChat mit mehreren Nutzern.

## Begriffe in dieser Anleitung

[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.

[Basis-URL (Base URL)](https://broadrouter.com/de/glossary/base-url/)

Eine Basis-URL ist die feste Stammadresse einer API, etwa https://api.example.com/v1, die ein Client vor jeden Endpoint-Pfad wie /chat/completions setzt. In OpenAI-kompatiblen SDKs lenkt eine geänderte Basis-URL, zusammen mit API-Schlüssel und Modell-ID, denselben Code zu einem anderen Anbieter.

[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.

[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.

[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.

[Prepaid-Guthaben (Prepaid Credit)](https://broadrouter.com/de/glossary/prepaid-credit/)

Prepaid-Guthaben ist Geld, das vor der Nutzung auf ein API-Konto eingezahlt wird. Jede Anfrage zieht ihre Kosten vom Guthaben ab, und wenn es aufgebraucht ist, stoppen abgerechnete Anfragen, bis Sie aufladen. So sind die Ausgaben auf das eingezahlte Geld begrenzt.

## Häufige Fragen

### Warum erscheint mein BroadNet-Endpoint nicht in LibreChat?

LibreChat verwirft einen Custom Endpoint ohne Fehlermeldung oder Logzeile, wenn name, baseURL, apiKey oder models.default fehlt oder falsch geschrieben ist. Prüfen Sie unter Docker außerdem, ob librechat.yaml unter /app/librechat.yaml gemountet ist und ob Sie neu gestartet haben.

### Kann jeder Nutzer seinen eigenen BroadNet-Schlüssel mitbringen?

Ja. Setzen Sie apiKey auf user\_provided. LibreChat fragt dann jeden Nutzer nach einem Schlüssel, sobald er den Endpoint zum ersten Mal auswählt, und speichert ihn verschlüsselt.

### Warum zeigt LibreChat „Missing API Key for BroadNet“?

Die in apiKey referenzierte Variable ist in .env nicht gesetzt. Der Endpoint erscheint trotzdem in der Auswahl, und der Fehler kommt erst beim Senden einer Nachricht. Ergänzen Sie die Variable und starten Sie LibreChat neu.

### Gehört /chat/completions in die baseURL von LibreChat?

Nein. LibreChat hängt /chat/completions standardmäßig an die baseURL an. Nutzen Sie https://inference.broadnet.ai/v1. Setzen Sie directEndpoint nur dann auf true, wenn die eingetragene URL bereits der vollständige Completions-Endpoint ist.

## Verwandte Anleitungen

-   [Open WebUI mit BroadNet Inference verbinden](https://broadrouter.com/de/guides/open-webui-openai-api/)
-   [Warum ein Reasoning-Modell eine leere Antwort liefert](https://broadrouter.com/de/guides/reasoning-tokens-empty-response/)
-   [Fehlercodes von BroadNet Inference: Wann ist ein Retry sinnvoll?](https://broadrouter.com/de/guides/errors-and-retries/)
-   [API-Schlüssel per IP-Allowlist an Ihre Server binden](https://broadrouter.com/de/guides/api-keys-ip-allow-lists/)
-   [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-librechat-custom-endpoint&utm_content=page-cta) ·

**Quellen**

-   [LibreChat-Dokumentation, Quick Start für Custom Endpoints (geprüft am 2026-11-14)](https://www.librechat.ai/docs/quick_start/custom_endpoints)
-   [LibreChat-Dokumentation, Struktur des Custom-Endpoint-Objekts (geprüft am 2026-11-14)](https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/custom_endpoint)
-   [API-Referenz von BroadNet Inference (geprüft am 2026-11-16) (auf Englisch)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-librechat-custom-endpoint&utm_content=sources)
