Zum Hauptinhalt springen
Cherry Studio ist ein plattformübergreifender Desktop-Client (Windows, macOS, Linux), der viele Modellanbieter in einer App zusammenführt. Fügen Sie Tokios als benutzerdefinierten OpenAI-Anbieter hinzu – zeigen Sie auf https://api.tokios.com/v1, fügen Sie einen sk-tok-…-Schlüssel ein und fügen Sie Ihren Tokios-Deployment-Namen als Modell hinzu – und Cherry Studio kommuniziert mit einem Modell, das auf Ihrer eigenen Hardware läuft, anstatt mit einem gehosteten Anbieter.

​
Voraussetzungen

Connector gepairt

Installieren und pairen Sie tokios-connector neben dem Modell, das Cherry Studio erreichen soll.

Modell registriert

Registrieren Sie ein Deployment (öffentlicher Name) für dieses Modell.

API-Schlüssel erstellt

Erstellen Sie einen sk-tok-…-Schlüssel, optional auf dieses Deployment beschränkt.

Unterstützte Backends

Stellen Sie sicher, dass Ihr lokales Backend (Ollama, llama.cpp, vLLM, LM Studio) läuft.

​
Tokios als Anbieter in Cherry Studio hinzufügen

1

Einstellungen für Modellanbieter öffnen

Öffnen Sie Settings (das Zahnradsymbol) und gehen Sie zum Tab Model Services. Einige Builds bezeichnen dies als Model Provider – die Dokumentation von Cherry Studio wird aus dem Chinesischen übersetzt, daher kann die genaue Bezeichnung je nach Version variieren.
2

Einen Anbieter hinzufügen

Klicken Sie auf + Add. Geben Sie im Dialogfeld Add Provider einen Provider name (z. B. Tokios) ein und setzen Sie Provider type auf OpenAI – das ist die Einstellung für jeden generischen OpenAI-kompatiblen Endpunkt.
3

API-Adresse und -Schlüssel festlegen

Füllen Sie die Anbieterfelder aus:
Fügen Sie /v1 selbst zur API address hinzu. Cherry Studio hängt den Pfad für einen benutzerdefinierten Anbieter nicht zuverlässig an, daher geben Sie die vollständige /v1-Basis an.
4

Ihr Deployment als Modell hinzufügen

Cherry Studio listet Modelle für einen benutzerdefinierten Anbieter nicht automatisch auf – fügen Sie eines manuell hinzu, indem Sie den öffentlichen Deployment-Namen verwenden, den Sie im Tab Models registriert haben, z. B. gemma-tunnel. Dies ist der Wert, den Cherry Studio im Feld model sendet; es ist nicht die lokale Modell-ID von Ollama, llama.cpp, vLLM oder LM Studio.
Ersetzen Sie gemma-tunnel durch den Deployment-Namen, den Sie registriert haben, und sk-tok-YOUR_KEY durch Ihren eigenen Schlüssel. Geben Sie keines davon in einer gemeinsam genutzten Konfigurationsdatei ein.

​
Desktop-App, Modell woanders

Die häufige Konfiguration, die dies löst: Cherry Studio läuft auf Ihrem Laptop oder Desktop, aber das Modell, das Sie möchten – größer als das, was diese Maschine ausführen kann – befindet sich auf einer Workstation oder einem Server woanders. Der Connector neben diesem Modell wählt Tokios an, und Cherry Studio ruft https://api.tokios.com/v1 mit Ihrem sk-tok-…-Schlüssel auf. Sie behalten die Benutzeroberfläche von Cherry Studio mit einem Modell, das nicht lokal auf der Maschine ist, auf der Sie tippen – keine eingehenden Ports, kein VPN.

​
Fehlerbehebung

Der von Cherry Studio gesendete API-Schlüssel fehlt, ist fehlerhaft oder wurde widerrufen. Stellen Sie sicher, dass Sie den vollständigen sk-tok-…-Schlüssel ohne zusätzlichen Leerzeichen eingefügt haben, und überprüfen Sie seinen Status im Tab Keys.
Der Modellwert, den Cherry Studio gesendet hat, stimmt nicht mit einem registrierten Deployment überein, oder die API address enthält /v1 nicht. Stellen Sie sicher, dass der Modellname mit dem öffentlichen Namen im Tab Models übereinstimmt und dass die Adresse https://api.tokios.com/v1 ist.
Der Connector für dieses Deployment ist offline oder hat sein Gleichzeitigkeitlimit erreicht. Überprüfen Sie den Tab Connectors – der Connector muss als Online angezeigt werden, und die Maschine, auf der er läuft, muss noch hoch und erreichbar sein.

​
Nächste Schritte

Kompatible Clients

Sehen Sie sich die Basis-URL- und Schlüsseleinstellung für andere OpenAI- und Anthropic-kompatible Clients an.

API-Schlüssel

Erstellen, beschränken und rotieren Sie sk-tok-…-Schlüssel für Teammitglieder und Agenten.