> ## 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 AnythingLLM

> Platform API guide - Ace Data Cloud

[AnythingLLM](https://anythingllm.com/) ist ein Open-Source-Client mit der Positionierung „Dokumente → privates ChatGPT“. Das Kernkonzept ist **Workspace** – jeder Workspace besteht aus einer Gruppe von Dokumenten, einer Gruppe von Benutzern und einer Gruppe von Agent-Tools und ist unabhängig isoliert. Es wurde speziell für Dokumenten-Dialoge entwickelt und bietet sowohl eine Desktop-App als auch Docker-Varianten. Unter **LLM Provider** ist [OpenAI (Generic)](https://docs.anythingllm.com/setup/llm-configuration/cloud/openai-generic) integriert, wo eine benutzerdefinierte Base URL eingetragen werden kann, sodass das Dialogmodell direkt auf Ace Data Cloud ausgerichtet werden kann. Dieser Artikel stellt den Konfigurationsprozess vor.

## Antragsprozess

Um Ace Data Cloud in AnythingLLM einzubinden, rufen Sie zunächst die [Ace Data Cloud-Konsole](https://platform.acedata.cloud/console/applications) auf, holen Sie sich Ihren API-Token und bewahren Sie ihn als Reserve auf.

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

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

Bei der ersten Beantragung wird ein kostenloses Guthaben verschenkt, sodass Sie die Modelldienste von Ace Data Cloud kostenlos ausprobieren können.

## AnythingLLM herunterladen

Für die persönliche Nutzung können Sie die [Desktop-Version](https://anythingllm.com/download) herunterladen. Die Vektordatenbank (LanceDB) läuft lokal, die Dokumentensuche ist vollständig offline, und nur beim Aufrufen des Modells wird eine Internetverbindung benötigt. Für Team- und Mehrbenutzerszenarien verwenden Sie die [Docker-Bereitstellung](https://docs.anythingllm.com/installation-docker/overview).

## Dialogmodell konfigurieren

Starten Sie AnythingLLM und gehen Sie zu **Settings → LLM Preference**. Wählen Sie als Provider **OpenAI (Generic)** (wählen Sie nicht das normale OpenAI, da dieses fest auf `api.openai.com` verweist und keine benutzerdefinierte Base URL besitzt). Die offizielle Dokumentation finden Sie unter [OpenAI (Generic) LLM Provider](https://docs.anythingllm.com/setup/llm-configuration/cloud/openai-generic).

| Feld | Wert | Beschreibung |
| - | - | - |
| Base URL | `https://api.acedata.cloud/v1` | **Muss mit `/v1` enden** |
| API Key | Ihr Ace Data Cloud Token | Der aus der Konsole kopierte Token |
| Selected Model | Aktuelle Modell-ID | Bevorzugt die automatisch von `/models` geladene Liste verwenden; falls keine Rückgabe erfolgt, nach der oben beschriebenen Methode abfragen und manuell eintragen |
| Model context window | Gemäß dem ausgewählten Modell | Das Kontextlimit aus dem aktuellen Modellkatalog lesen, nicht die Werte anderer Modelle übernehmen |

![AnythingLLM Generic OpenAI-Konfigurationsoberfläche](https://cdn.acedata.cloud/a155f5476de7.png)

> Die Modellfähigkeiten und das Kontextlimit richten sich nach dem aktuellen Modellkatalog.

Beachten Sie die Pfadregeln der Base URL:

| 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 verwendbar |
| `https://api.acedata.cloud/openai/v1` | `https://api.acedata.cloud/openai/v1/chat/completions` | 404 (unter `/openai` gibt es kein `/v1`) |
| `https://api.acedata.cloud` | `https://api.acedata.cloud/chat/completions` | 404 (`/v1` fehlt) |

## Embedding-Modell konfigurieren

Der Kern von AnythingLLM ist RAG und benötigt ein Embedding-Modell, um Dokumente zu vektorisieren. Seine **Embedding Preference** und LLM Preference sind zwei voneinander unabhängige Konfigurationen – siehe [Embedder-Konfigurationsübersicht](https://docs.anythingllm.com/setup/embedder-configuration/overview). Der integrierte **AnythingLLM Embedder（Built-in / Native）** läuft direkt lokal, ist sofort einsatzbereit und erfordert keine Konfiguration; er ist die Standard- und empfohlene Wahl:

Gehen Sie zu **Settings → Embedding Preference** und behalten Sie als Provider den standardmäßigen **AnythingLLM Embedder** bei. Sie müssen keine Schlüssel eintragen. Er vektorisiert Dokumente lokal; sowohl Originaltexte als auch Vektoren werden in der lokalen LanceDB gespeichert und nicht in die Cloud hochgeladen.

> Die Embedder-Optionen von AnythingLLM (Cloud: OpenAI / Azure OpenAI / Cohere; lokal: Built-in, LM Studio, [LocalAI](https://docs.anythingllm.com/setup/embedder-configuration/local/localai), Ollama) werden jeweils in ihren festen Formen eingebunden. Dabei verweist das Cloud-OpenAI-Embedding fest auf `api.openai.com` und unterstützt keine benutzerdefinierte Base URL; wenn Sie einen benutzerdefinierten Endpunkt verwenden möchten, können Sie den **Generic OpenAI** Embedder verwenden (ebenfalls mit einem Base-URL-Feld, das auf `text-embedding-3-large` von Ace Data Cloud verweisen kann) oder den lokalen **LocalAI** Embedder. Das Dialogmodell in diesem Artikel verwendet Ace Data Cloud, während das Embedding den integrierten lokalen Embedder von AnythingLLM verwendet; beide beeinflussen sich nicht gegenseitig.

## Modell auswählen

Der Modellkatalog wird kontinuierlich aktualisiert. Verwenden Sie bevorzugt die automatisch vom Client geladene Modellliste; wenn eine manuelle Eingabe erforderlich ist, fragen Sie zunächst `GET https://api.acedata.cloud/v1/models` ab, um die aktuelle Modell-ID zu erhalten, und wählen Sie dann entsprechend den vom Client unterstützten Fähigkeiten für Kontext, Bilder und Tool-Aufrufe.

## Integration überprüfen

Wenn Sie nicht sicher sind, ob das Problem bei AnythingLLM oder beim 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 sowohl Token als auch Endpunkt bereit sind; wenn `HTTP 403 used_up` zurückgegeben wird, bedeutet dies, dass der Token gültig ist, aber das Guthaben nicht ausreicht. Laden Sie es einfach in der [Konsole](https://platform.acedata.cloud/console/applications) auf.

## Erweitert: Workspace und Dokumenten-Dialog

Laden Sie nach dem Erstellen eines neuen Workspace PDF-, Word-, Markdown- und andere Dokumente hoch. AnythingLLM teilt diese nach Absätzen auf, erzeugt mit dem lokalen Embedder Vektoren und speichert sie in der lokalen LanceDB. Beim Dialog ruft es zunächst relevante Ausschnitte ab und übergibt dann die Ausschnitte zusammen mit Ihrer Frage an das Dialogmodell (also Ace Data Cloud) zur Beantwortung; unter der Antwort werden die zitierten Quellen markiert. Oben in jedem Workspace können Sie zwischen den Modi **Query** (Antworten nur auf Grundlage der Dokumente) und **Chat** (Mischung mit allgemeinem Wissen) wechseln. Für ernsthafte Szenarien wird empfohlen, den Query-Modus zu verwenden, um Halluzinationen zu vermeiden. Bei der Docker-Bereitstellung können Umgebungsvariablen wie `GENERIC_OPEN_AI_BASE_PATH`, `GENERIC_OPEN_AI_API_KEY`, `GENERIC_OPEN_AI_MODEL_PREF` verwendet werden, um dieselbe Dialogmodell-Integration voreinzustellen und den Mehrbenutzermodus zu aktivieren.

## Häufige Fragen

### Hinweis 404 / connection fail

In der Regel wurde die Base URL als `.../openai/v1` eingetragen oder `/v1` vergessen. Ändern Sie sie zu `https://api.acedata.cloud/v1`.

### Nach dem Hochladen eines Dokuments ist kein Dialog möglich

Bitte bestätigen Sie, dass unter **Settings → Embedding Preference** ein verwendbarer Embedder ausgewählt ist (der standardmäßige AnythingLLM Embedder kann lokal ausgeführt werden und erfordert keine zusätzliche Konfiguration), und laden Sie das Dokument erneut hoch, um Vektoren zu erzeugen.

### Hinweis 401 Unauthorized

Bitte bestätigen Sie, dass im API Key das Token von Ace Data Cloud eingefügt ist (ohne das Präfix `Bearer`, ohne zusätzliche Leerzeichen) und dass das Guthaben der zugehörigen Anwendung ausreichend ist.

### Werden lokale Dokumente in die Cloud hochgeladen

Nein. Die Originaltexte der Dokumente werden lokal in LanceDB gespeichert, nur die bei der Suche gefundenen Ausschnitte und Ihre Frage werden an das Modell gesendet.

## Mehr erfahren

* [AnythingLLM Offizielle Website](https://anythingllm.com/) ｜ [AnythingLLM GitHub](https://github.com/Mintplex-Labs/anything-llm) ｜ [Docker-Bereitstellungsdokumentation](https://docs.anythingllm.com/installation-docker/overview)
* [AnythingLLM OpenAI (Generic) LLM Provider-Dokumentation](https://docs.anythingllm.com/setup/llm-configuration/cloud/openai-generic)
* [AnythingLLM Übersicht der Embedder-Konfiguration](https://docs.anythingllm.com/setup/embedder-configuration/overview)
* [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.