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

# Ace Data Cloud in Jan verwenden

> Platform API guide - Ace Data Cloud

[Jan](https://jan.ai/) ist ein Open-Source-KI-Desktop-Client mit Offline-Priorität, der Modelle sowohl lokal ausführen als auch über die **Remote Engine** auf OpenAI-kompatible Endpunkte zugreifen kann. Dieser Artikel beschreibt, wie Sie Ace Data Cloud anbinden.

## Antragsprozess

Um Ace Data Cloud in Jan anzubinden, rufen Sie zunächst die [Ace Data Cloud-Konsole](https://platform.acedata.cloud/console/applications) auf, um Ihren API-Token abzurufen und für später bereitzuhalten.

![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 zu dieser Seite zurück.

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

## Jan herunterladen

Laden Sie auf der [offiziellen Jan-Website](https://jan.ai/) das Paket für Ihre Plattform herunter (Windows, macOS, Linux). Für Apple-Silicon-Geräte laden Sie bitte das arm64-Paket herunter, um die beste Leistung zu erzielen.

## Ace Data Cloud konfigurieren

Jan unterteilt Modelle in **Local Engine** (lokale Ausführung) und **Remote Engine** (Drittanbieter-API). Ace Data Cloud verwendet das OpenAI-kompatible Protokoll und wird über die Remote Engine angebunden.

Öffnen Sie Jan, gehen Sie zu **Settings → Model Providers**, suchen Sie die **OpenAI**-Karte und bearbeiten Sie diese:

| Feld | Wert | Beschreibung |
| - | - | - |
| API Key | Ihr Ace Data Cloud Token | In der Konsole kopierter Token |
| Base URL | `https://api.acedata.cloud/v1` | **Muss mit `/v1` enden, ohne Schrägstrich am Ende** |

> Dass die Base URL mit `/v1` enden muss, ist eine ausdrückliche Vorgabe der offiziellen Jan-Dokumentation. Wenn Sie die ursprüngliche OpenAI-Konfiguration nicht überschreiben möchten, können Sie über „+ Add Provider“ einen neuen Provider vom Typ `openai-compatible` erstellen und denselben Inhalt eintragen.

![Jan-Konfigurationsoberfläche zum Hinzufügen eines AceDataCloud Providers](https://cdn.acedata.cloud/26017d28afa1.png)

Nach dem Speichern des benutzerdefinierten Providers versucht Jan zunächst, über `{Base URL}/models` die Modellliste abzurufen. Wenn die aktuelle Version oder der Endpunkt keine verfügbare Liste zurückgibt, klicken Sie unten auf derselben Bearbeitungsseite auf **+ Add Model**, um die Modell-ID manuell einzutragen. Nach dem Hinzufügen erscheint das Modell im Dropdown-Menü oben links und wird mit einem „Cloud“-Symbol als Remote- bzw. lokales Modell gekennzeichnet.

![Jan-Provider-Modellverwaltungsoberfläche](https://cdn.acedata.cloud/ae485550946c.png)

> `MODEL_ID` ist ein Platzhalter; bitte rufen Sie den [Modellkatalog](https://platform.acedata.cloud/models) auf und ersetzen Sie ihn durch den Namen des Zielmodells; bei einer genauen Prüfung gilt der `id`-Wert in der Antwort von `/v1/models`. Dieser Wert ist der Modellname, der vom API-Parameter `model` verwendet wird, und nicht die UUID des Dienstes oder der API.

## Modell auswählen

Der [Modellkatalog](https://platform.acedata.cloud/models) wird kontinuierlich aktualisiert. Verwenden Sie bevorzugt die automatisch vom Client geladene Modellliste; wenn eine manuelle Eingabe erforderlich ist, rufen Sie zunächst `GET https://api.acedata.cloud/v1/models` auf, kopieren Sie den `id`-Wert des Zielmodells aus dem `data`-Array der Antwort und wählen Sie anschließend entsprechend den vom Client unterstützten Fähigkeiten für Kontext, Bilder und Tool-Aufrufe.

## Anbindung überprüfen

Wenn Sie nicht sicher sind, ob das Problem bei Jan 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"}]
  }'
```

Wenn ein OpenAI-kompatibles `chat.completion`-Objekt zurückgegeben wird, sind Token und Endpunkt bereit; wenn `HTTP 403 used_up` zurückgegeben wird, bedeutet dies, dass der Token gültig ist, aber das Guthaben nicht ausreicht. Laden Sie dann einfach über die [Konsole](https://platform.acedata.cloud/console/applications) Guthaben auf.

## Fortgeschritten: Lokale + Cloud-Hybridnutzung

Jan verfügt über einen aktivierbaren lokalen OpenAI-kompatiblen API-Server (Settings → Local API Server). Nach der Aktivierung lauscht er auf `http://localhost:1337/v1/chat/completions` und führt die von Ihnen heruntergeladenen lokalen Modelle aus. Dadurch können Sie in Frameworks wie LangChain / LlamaIndex die Base URL für kostenlose Tests auf lokal setzen und bei komplexen Aufgaben zu den Remote-Modellen von Ace Data Cloud wechseln. Beim Wechseln des Modells geht der Gesprächskontext nicht verloren.

## Häufige Fragen

### Meldung Connection error oder 404

In der Regel fehlt `/v1` in der Base URL. Ändern Sie sie in `https://api.acedata.cloud/v1` (sie muss mit `/v1` enden und darf nicht als `.../openai/v1` geschrieben werden).

### Meldung 401 Unauthorized

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

### Remote-Modelle erscheinen nicht im Dropdown-Menü

Klicken Sie zunächst auf die Schaltfläche zum Aktualisieren der Modelle, um `/v1/models` auszulösen; wenn die automatische Erkennung fehlschlägt, fügen Sie über **+ Add Model** manuell den `id`-Wert des Modells aus dem Katalog unverändert hinzu.

### Können Bilder hochgeladen werden, damit das Modell sie analysiert

Ja, aber Sie müssen aus dem aktuellen Modellkatalog ein Modell auswählen, das ausdrücklich visuelle Eingaben unterstützt.

## Mehr erfahren

* [Offizielle Jan-Website](https://jan.ai/) ｜ [Jan GitHub](https://github.com/menloresearch/jan) ｜ [Jan-Dokumentation](https://jan.ai/docs)
* [Offizielle Jan-Dokumentation zur Anbindung benutzerdefinierter OpenAI-kompatibler Endpunkte](https://jan.ai/docs/desktop/remote-models/custom-endpoint)
* [Offizielle Jan-Dokumentation zum lokalen API-Server](https://jan.ai/docs/desktop/api-server)
* [Ace Data Cloud OpenAI Chat Completions API-Dokumentation](https://platform.acedata.cloud/documents/openai-chat-completions)
* [Ace Data Cloud-Dienstliste](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.