Dokumentation

Cherry Studio

Für benutzerdefinierte Anbieter verwendet Cherry Studio je Protokoll eine eigene Root-Adresse — für OpenAI, Anthropic und Gemini. Fügen Sie den Schlüssel und die Root-Adressen ein, klicken Sie auf Sync Models, und der Katalog füllt die Auswahl automatisch.

Settings → Model Services → ein benutzerdefinierter Anbieter: Schlüssel und API-Adresse einfügen, Get Model List anklicken, und der gesamte Katalog wird in die Auswahl geladen.

Cherry Studio

设置 → 模型服务 → 添加 → 添加自定义提供商 (Settings → Model Services → Add → Add Custom Provider)

  提供商名称 / Provider name    Kunavo
  API 密钥 / API Key            sk-kn-...
  端点设置 / Endpoint settings
    OpenAI                     https://api.kunavo.com/v1
    Anthropic                  https://api.kunavo.com
  → 同步模型 (Sync Models), then add the models you want
  → 检测 (Test) to confirm

同步模型 / Modelle synchronisieren ruft GET /v1/models mit dem eingegebenen Schlüssel über die Root-Adresse des ausgefüllten Felds auf. Das ist zugleich der schnellste Test, ob das Wertepaar stimmt — eine leere Liste deutet fast immer auf den Schlüssel oder die Adresse hin, nicht auf den Anbieter.

Jedes Endpunktfeld erwartet eine Root-Adresse, keine vollständige Endpunkt-URL. Cherry Studio fügt sein eigenes Versionssegment hinzu (außer wenn Ihre Root-Adresse bereits mit einem solchen endet; daher werden https://api.kunavo.com und https://api.kunavo.com/v1 im OpenAI-Feld beide korrekt aufgelöst) und hängt anschließend immer die eigene Route für das jeweilige Feld an. Fügen Sie die vollständige Endpunkt-URL ein — eine, die bereits mit /chat/completions oder /messages endet —, wird die Route ein zweites Mal angehängt und die Anfrage schlägt mit einem 404-Fehler fehl.

Noch kein Schlüssel? Erstelle ein Kunavo-Konto, erstelle einen Schlüssel (er beginnt mit sk-kn-) und füge ab $10 Guthaben hinzu – Aufrufe werden aus diesem Guthaben bezahlt, fehlgeschlagene Aufrufe werden nicht berechnet. Das Dashboard öffnet anschließend die Cherry Studio-Einrichtung.

Schritt für Schritt

Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
Öffnen Sie 设置 → 模型服务 (Einstellungen → Model Services) und klicken Sie auf 添加自定义提供商 (Benutzerdefinierten Anbieter hinzufügen).
Füllen Sie API 密钥 (den Schlüssel) und das OpenAI-Endpunktfeld (https://api.kunavo.com/v1) aus.
Füllen Sie auch das Feld Anthropic (https://api.kunavo.com) aus — es befindet sich unter OpenAI in 端点设置 (Endpunkteinstellungen). Cherry Agent und jedes Modell, das über das Anthropic-Messages-Protokoll geleitet wird, verwenden ausdrücklich dieses Feld, nicht das OpenAI-Feld. Die übrigen Endpunkttypen finden Sie unter 更多设置 (Weitere Einstellungen).
Speichern Sie und klicken Sie anschließend in der Modellliste des Anbieters auf 同步模型 (Modelle synchronisieren). Fügen Sie die gewünschten Chat-Modelle hinzu und klicken Sie auf 检测 (Testen), um eines davon durchgängig zu überprüfen.
Weisen Sie Modelle den einzelnen Assistenten statt global zu — Cherry Studio verwaltet ein Modell pro Assistent. So können ein günstiges Standardmodell und ein teures Spezialmodell nebeneinander bestehen.

Abgeglichen mit Cherry Studio-Dokumentation zu Anbietern am 1. Oktober 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in Cherry Studio.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Modell-ID	Kunavo: Ein- und Ausgabe	Wo es in Cherry Studio hineinpasst
`claude-sonnet-5`	$1.40 / $7.00	der alltägliche Assistent
`claude-opus-5`	$3.50 / $17.50	ein Assistent für schwierige Probleme
`claude-haiku-4-5`	$0.70 / $3.50	Übersetzungen, Zusammenfassungen und andere Aufgaben mit hohem Volumen
`gpt-5-6-terra`	$0.70 / $4.20	lange Dokumente und große eingefügte Kontexte

Die Abrechnung erfolgt pro Token aus einem vorausbezahlten Guthaben ohne Monatsgebühr – siehe Abrechnung. Bei wiederholtem Kontext – dem Großteil dessen, was ein Editor oder Chat-Client sendet – verändert Prompt-Caching die Rechnung stärker als die Modellwahl.

Häufig gestellte Fragen

Wie füge ich Cherry Studio einen benutzerdefinierten API-Anbieter hinzu?

Öffnen Sie Einstellungen → Model Services (设置 → 模型服务) und klicken Sie auf Add Custom Provider (添加自定义提供商). Für jeden Endpunkttyp ist eine eigene Root-Adresse vorgesehen — standardmäßig werden OpenAI und Anthropic angezeigt, unter More options (更多设置) außerdem OpenAI Responses, Gemini und die Bildendpunkte — sowie ein einzelner API-Schlüssel. Geben Sie den Schlüssel und die benötigten Endpunkt-Root-Adressen ein, klicken Sie auf Sync Models (同步模型), um den Katalog abzurufen, fügen Sie die gewünschten Modelle hinzu und verwenden Sie Test (检测), um zu prüfen, ob eines davon funktioniert.

Warum liefert Sync Models in Cherry Studio keine Ergebnisse?

Diese Schaltfläche ruft die Route /v1/models des OpenAI-Felds mit dem eingegebenen Schlüssel auf. Ein leeres Ergebnis deutet daher auf die Adresse in diesem Feld oder den Schlüssel hin, nicht auf Cherry Studio. Jedes Feld erwartet eine Root-Adresse — Cherry Studio fügt Version und Route selbst hinzu. Prüfen Sie daher, ob Sie versehentlich eine vollständige Endpunkt-URL eingefügt haben (eine, die bereits mit /chat/completions endet), und testen Sie dann dasselbe Wertepaar mit curl: Eine JSON-Antwort bedeutet, dass das Problem in der App liegt, ein 401 weist auf den Schlüssel hin.

Was bewirkt ein # am Ende des Cherry Studio-Endpunktfelds?

Laut der eigenen Dokumentation von Cherry Studio wird damit das Feld auf einen festen Pfad gesetzt, für Endpunkte, deren Route nicht dem Standard entspricht. Kunavos OpenAI- und Anthropic-Endpunkte sind beide standardkonform. Sie benötigen diese Angabe also nicht — tragen Sie die Root-Adresse mit oder ohne eigenes /v1 ein und lassen Sie Cherry Studio den Rest ergänzen.

Kann Cherry Studio Claude-Modelle ohne ein Anthropic-Konto verwenden?

Ja, wenn ein Gateway sie bereitstellt — tragen Sie Kunavos Adresse ausdrücklich in das Anthropic-Feld ein, nicht in das OpenAI-Feld, da Cherry Agent und jedes Modell, das über das Anthropic-Messages-Protokoll geleitet wird, dieses Feld verwenden. Cherry Studio sendet die Modell-ID an den Endpunkt, der im Anbietereintrag angegeben ist. Eine Claude-ID wird also dort aufgelöst, und als Zugangsinformation hält Cherry Studio nur den Schlüssel des Endpunkts vor.