---
title: Open WebUI | RunAPI
description: Open WebUI installieren, RunAPI als OpenAI-kompatible Verbindung hinzufügen,
  ein Modell auswählen und einen Chat überprüfen.
url: https://runapi.ai/de/docs/resources/application-practices/open-webui.md
canonical: https://runapi.ai/de/docs/resources/application-practices/open-webui
locale: de
---

> HTML-Version: https://runapi.ai/de/docs/resources/application-practices/open-webui
> Website-Index für KI-Agenten: https://runapi.ai/llms.txt

# Open WebUI

Open WebUI über seine OpenAI-kompatible Verbindung mit RunAPI verbinden.
Sie benötigen Open WebUI-Administratorzugriff und einen Standard-RunAPI-API-Schlüssel
aus der [Authentifizierungsanleitung](https://runapi.ai/de/docs/guides/authentication.md).

## Open WebUI installieren

Folgen Sie der [offiziellen Open WebUI-Schnellstartanleitung][1] für Ihre Plattform. Für eine lokale Docker-Installation kann das offizielle Image gestartet werden mit:



[1]: https://docs.openwebui.com/getting-started/quick-start/

```shell
docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main
```

Öffnen Sie die Anwendung, erstellen Sie das Administratorkonto und melden Sie sich an, bevor Sie die Verbindung hinzufügen.

## RunAPI-Verbindung hinzufügen

1.  Öffnen Sie **Admin Settings → Connections → OpenAI** und wählen Sie **Add
    Connection**.
2.  Setzen Sie die URL auf `https://runapi.ai/v1` und geben Sie Ihren RunAPI-API-Schlüssel ein.
3.  Lassen Sie **Model IDs (Filter)** beim ersten Verbindungsversuch leer,
    damit Open WebUI die verfügbaren Modelle ermitteln kann.
4.  Speichern Sie die Verbindung und warten Sie, bis die Überprüfung abgeschlossen ist.

Open WebUI sendet die Verbindungsprüfung von seinem Backend aus und verwendet `GET
/v1/models` zur Erkennung. Die RunAPI-URL ist öffentliches HTTPS, sodass eine Docker-Installation für diese Verbindung kein `host.docker.internal` benötigt.

## Ein Modell auswählen

Öffnen Sie einen neuen Chat und wählen Sie ein RunAPI-Modell aus der Chat-Modellauswahl. Verwenden Sie den [Modellkatalog](https://runapi.ai/de/models), um den aktuellen Modellbezeichner und die Funktionen zu bestätigen.

Wenn die Discovery den Selektor nicht befüllt, bearbeiten Sie die Verbindung und fügen Sie den genauen Bezeichner unter **Model IDs (Filter)** hinzu. Ein Modell-Discovery-Fehler und ein Chat Completions-Fehler sind separate Signale; testen Sie das manuell hinzugefügte Modell, bevor Sie die Verbindung entfernen.

## Verbindung überprüfen

Senden Sie einen kurzen Prompt wie `Reply with the word connected.` Eine normale
gestreamte oder vollständige Antwort bestätigt, dass Open WebUI das
ausgewählte RunAPI-Modell verwenden kann.

## Fehlerbehebung

* **Überprüfung gibt `401` oder `403` zurück:** Ersetzen Sie den API-Schlüssel in der Verbindung durch einen gültigen Standard-Schlüssel aus der [Authentifizierungsanleitung](https://runapi.ai/de/docs/guides/authentication.md).
* **Kein RunAPI-Modell erscheint:** Vergewissern Sie sich, dass die URL auf `/v1` endet, fügen Sie dann eine aktuelle Kennung zu **Model IDs (Filter)** hinzu und wiederholen Sie den Chat.
* **Das Modell ist sichtbar, aber der Chat schlägt fehl:** Vergewissern Sie sich, dass die Kennung OpenAI-kompatible Chat Completions im [Modellkatalog](https://runapi.ai/de/models) unterstützt, und prüfen Sie dann die Open WebUI-Backend-Logs auf den Anfragestatus.
* **Eine lokale URL funktioniert im Browser, aber nicht in Open WebUI:** Open WebUI-Verbindungen stammen von dessen Backend. Dies betrifft nicht die öffentliche URL `https://runapi.ai/v1`, ist aber für andere lokale Verbindungen relevant.

Für das gemeinsame Protokollverhalten verwenden Sie den [LLM API
Quickstart](https://runapi.ai/de/docs/guides/llm-api/quickstart.md). Für Anfrage- und Antwortfelder verwenden Sie die [Chat Completions API
Referenz](https://runapi.ai/de/docs/api/openai/chat-completions.md).

---

## Mehr von RunAPI

- [Startseite](https://runapi.ai/de/.md)
- [Modellkatalog](https://runapi.ai/de/models.md)
- [Preise](https://runapi.ai/de/pricing.md)
- [Anbieter](https://runapi.ai/de/models)
- [Dokumentation](https://runapi.ai/de/docs/guides)
- [SDKs](https://runapi.ai/de/sdk.md)
- [CLI](https://runapi.ai/de/cli.md)
- [MCP Server](https://runapi.ai/de/mcp.md)
- [Claude Code vs Cursor](https://runapi.ai/de/claude-code-vs-cursor.md)
- [Cursor API-Einrichtung](https://runapi.ai/de/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/de/openrouter-alternative.md)
- [Enterprise](https://runapi.ai/de/contact.md)
- [Kontakt](https://runapi.ai/de/contact.md)
- [Bedingungen](https://runapi.ai/de/terms.md)
- [Datenschutz](https://runapi.ai/de/privacy.md)
- [Website-Index für KI-Agenten](https://runapi.ai/llms.txt)

Kontakt: contact@runapi.ai

## Strukturierte Daten

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "de",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/de",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/de/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "de",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/de",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/deicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "de",
    "@type": "TechArticle",
    "headline": "Open WebUI",
    "description": "Open WebUI installieren, RunAPI als OpenAI-kompatible Verbindung hinzufügen, ein Modell auswählen und einen Chat überprüfen.",
    "url": "https://runapi.ai/de/docs/resources/application-practices/open-webui",
    "mainEntityOfPage": "https://runapi.ai/de/docs/resources/application-practices/open-webui"
  }
]
```
