> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Verwendung von Ace Data Cloud in Open WebUI

> Platform API guide - Ace Data Cloud

[Open WebUI](https://openwebui.com/) (ehemals Ollama WebUI) ist ein Open-Source-AI-Client, der mehrere Benutzer, Wissensdatenbanken, RAG und private Bereitstellung unterstützt. Es unterstützt benutzerdefinierte OpenAI-kompatible Endpunkte und kann daher mit Ace Data Cloud verbunden werden. Dieser Artikel stellt den Konfigurationsprozess vor.

## Antragsprozess

Um Ace Data Cloud in Open WebUI einzubinden, rufen Sie zunächst die [Ace Data Cloud-Konsole](https://platform.acedata.cloud/console/applications) auf, um Ihren API-Token abzurufen und für die spätere Verwendung aufzubewahren.

![Ace Data Cloud API Key abrufen](https://cdn.acedata.cloud/dvc3cg.jpg)

Falls Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, um sich zu registrieren und anzumelden. Nach der Anmeldung oder Registrierung kehren Sie automatisch zu dieser Seite zurück.

Bei der ersten Beantragung erhalten Sie ein kostenloses Guthaben und können die Modelldienste von Ace Data Cloud kostenlos testen.

## Ace Data Cloud bereitstellen und konfigurieren

Open WebUI bindet OpenAI-kompatible Endpunkte über Umgebungsvariablen ein und kann mit einem einzigen Docker-Befehl bereitgestellt werden (ersetzen Sie `{token}` durch Ihren Token):

```bash theme={null}
docker run -d \
  --name open-webui \
  -p 3000:8080 \
  -e WEBUI_SECRET_KEY=$(openssl rand -base64 32) \
  -e OPENAI_API_BASE_URL=https://api.acedata.cloud/v1 \
  -e OPENAI_API_KEY={token} \
  -v open-webui:/app/backend/data \
  ghcr.io/open-webui/open-webui:main
```

| Umgebungsvariable | Funktion |
| - | - |
| `OPENAI_API_BASE_URL` | Ace Data Cloud-Endpunkt, **muss mit `/v1` enden** |
| `OPENAI_API_KEY` | Ihr Token |
| `WEBUI_SECRET_KEY` | Verschlüsselungsschlüssel für die Sitzung, wird automatisch generiert |
| `-v open-webui:/app/backend/data` | Persistente Gesprächs- / Benutzerdaten |

Öffnen Sie `http://IP-Ihres-Servers:3000`; das erste registrierte Konto wird automatisch zum Administrator. Beachten Sie die Pfadregeln der Base URL:

| OPENAI\_API\_BASE\_URL | Tatsächliche Anfrage | Ergebnis |
| - | - | - |
| `https://api.acedata.cloud/v1` | `https://api.acedata.cloud/v1/chat/completions` | Korrekt |
| `https://api.acedata.cloud/openai` | `https://api.acedata.cloud/openai/chat/completions` | Ebenfalls verfügbar |
| `https://api.acedata.cloud/openai/v1` | `https://api.acedata.cloud/openai/v1/chat/completions` | 404 (unter `/openai` gibt es kein `/v1`) |

Gehen Sie nach der Anmeldung zu **Admin Panel → Settings → Connections** und klicken Sie auf „Verify Connection“, um die Verbindung zu überprüfen; unter **Settings → Models** können Sie häufig verwendete Modelle filtern und anheften.

> Neben der Verwendung von Umgebungsvariablen unterstützt Open WebUI auch das direkte Hinzufügen von Verbindungen über die Benutzeroberfläche: Gehen Sie zu **Admin Settings → Connections**, klicken Sie auf ➕ und geben Sie URL (`https://api.acedata.cloud/v1`) sowie API Key ein. Open WebUI ruft automatisch `/models` auf, um die Modellliste abzurufen. Weitere Details finden Sie in der offiziellen Dokumentation [Starting With OpenAI-Compatible Servers](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible).

![Open WebUI Ace Data Cloud Connection-Konfigurationsoberfläche](https://cdn.acedata.cloud/f366abfd935d.png)

> `MODEL_ID` wird nur zur Demonstration einer optionalen Allow List verwendet; wenn es leer bleibt, werden alle von `/models` zurückgegebenen Modelle angezeigt.

## Modell auswählen

Der Modellkatalog wird kontinuierlich aktualisiert. Verwenden Sie vorrangig die automatisch vom Client geladene Modellliste; falls eine manuelle Eingabe erforderlich ist, fragen Sie zuerst `GET https://api.acedata.cloud/v1/models` ab, um die aktuelle Modell-ID zu erhalten, und wählen Sie dann entsprechend der vom Client unterstützten Kontext-, Bild- und Tool-Call-Fähigkeiten.

## Anbindung überprüfen

Wenn Sie nicht sicher sind, ob das Problem bei Open WebUI oder im Netzwerk liegt, können Sie zunächst den Endpunkt direkt mit curl überprüfen (ersetzen Sie `{token}` durch Ihren Token):

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/v1/chat/completions' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "ping"}]
  }'
```

Die Rückgabe eines OpenAI-kompatiblen `chat.completion`-Objekts bedeutet, dass Token und Endpunkt bereit sind; falls `HTTP 403 used_up` zurückgegeben wird, ist der Token gültig, aber das Guthaben reicht nicht aus. Laden Sie es einfach in der [Konsole](https://platform.acedata.cloud/console/applications) auf.

## Fortgeschritten: Wissensdatenbank und mehrere Benutzer

Die Wissensdatenbank (RAG) von Open WebUI verwendet standardmäßig ChromaDB zum Speichern von Vektoren. Als Einbettungsmodell kann `text-embedding-3-large` (über Ace Data Cloud) angegeben werden. Die Originaldokumente werden nur auf Ihrem Server gespeichert, und nur die passenden Abschnitte werden an das Modell gesendet. Unter **Admin Panel → Users** können Sie Benutzerrollen (Pending / User / Admin) verwalten; es wird empfohlen, „Default User Role“ auf `pending` zu setzen, sodass neue Benutzer erst nach einer Prüfung verwendet werden können, um zu vermeiden, dass Außenstehende sich beliebig registrieren und Guthaben verbrauchen. Wenn Sie einen nginx-Reverse-Proxy verwenden, fügen Sie `proxy_buffering off;` und `client_max_body_size 100M;` hinzu.

## Häufige Fragen

### Meldung Connection error / 404

In der Regel wurde `OPENAI_API_BASE_URL` als `.../openai/v1` angegeben oder `/v1` vergessen. Ändern Sie es zu `https://api.acedata.cloud/v1`.

### Nach dem Hochladen eines Dokuments ist keine Unterhaltung möglich

Wählen Sie in den RAG-Einstellungen des Admin Panels als Einbettungsmodell `text-embedding-3-large` (OpenAI provider) aus.

### Daten gehen nach einem Container-Neustart verloren

Beim Start muss das Datenvolume `-v open-webui:/app/backend/data` eingebunden werden.

## Mehr erfahren

* [Open WebUI offizielle Website](https://openwebui.com/) ｜ [Open WebUI GitHub](https://github.com/open-webui/open-webui) ｜ [Schnellstart-Dokumentation](https://docs.openwebui.com/getting-started/quick-start)
* [Offizielle Dokumentation zur Anbindung von OpenAI-kompatiblen Endpunkten in Open WebUI](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible)
* [Ace Data Cloud OpenAI Chat Completions API-Dokumentation](https://platform.acedata.cloud/documents/openai-chat-completions)
* [Ace Data Cloud Serviceliste](https://platform.acedata.cloud/documents)
* [Ace Data Cloud-Konsole](https://platform.acedata.cloud/console)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.