Der Pfad zum Konfigurieren der API in Cherry Studio lautet Settings → Model Provider → Add Provider. Geben Sie den API Key ein, tragen Sie in den Feldern OpenAI und Anthropic unter Endpoint settings jeweils die Basisadresse ein, speichern Sie, rufen Sie mit „Sync models“ die Modelle ab und prüfen Sie sie mit „Check“. Wichtig vorab: Cherry Studio hat keine koreanische UI, daher übernehmen wir die Menüs im englischen Original. Diese Seite basiert auf v2.1.4 vom 30. September 2026. Da sich der Anbieter-Dialog in v2 stark geändert hat, entspricht die Erklärung aus v1 mit „Type: OpenAI“ nicht mehr der aktuellen Oberfläche.
Ziel ist die Desktop-Version von CherryHQ/cherry-studio (AGPL-3.0, Windows, macOS und Linux). Am 1. Oktober 2026 war das Repository nicht archiviert; die aktuelle Version ist v2.1.4. Die gleichnamige App im App Store stammt von einem anderen Entwickler und ist nicht verbunden. Die integrierte UI umfasst 13 Sprachen, Koreanisch ist nicht verfügbar (laut UI-Übersetzungsdateien von v2.1.4); die Anleitung setzt daher eine englische UI voraus.
Schrittweise Konfiguration
Settings → Model Provider → Add Provider
(대화상자 제목: Add Custom Provider)
Provider Name Kunavo
API Key sk-kn-...
Endpoint settings
OpenAI https://api.kunavo.com/v1
Anthropic https://api.kunavo.com
More options
OpenAI Responses https://api.kunavo.com/v1 (선택)
Image Generation Base URL https://api.kunavo.com/v1 (선택)
Gemini 비워 둠
→ Save → 모델 목록에서 "Sync models" → 쓸 모델 추가 → "Check"- Klicken Sie unter Settings → Model Provider auf Add Provider. Der geöffnete Dialog trägt den Titel „Add Custom Provider“. Wenn Sie einen Dienst aus der Kategorie Coding Plan, mehrere Konten oder eine Trennung nach Projekten benötigen, können Sie oben über „Start from a preset (optional)“ auch mit einem vorhandenen Preset beginnen.
- Geben Sie Provider Name und API Key ein.
- Unter Endpoint settings befinden sich von Anfang an die beiden Felder OpenAI und Anthropic. Mindestens ein Text-Endpoint ist erforderlich (bei leerem Feld erscheint der Fehler „Configure at least one text endpoint“). Wenn Sie beide Felder ausfüllen, können Sie Modelle nicht nur für Chats, sondern auch für Agents und Funktionen auswählen, die das Anthropic-Format verwenden.
- Wenn Sie More options aufklappen, erscheinen die Felder OpenAI Responses, Gemini, Image Generation Base URL und Image Edit Base URL. Nicht benötigte Felder lassen Sie leer.
- Prüfen Sie nach dem Speichern, ob der Anbieter aktiviert (Enable) ist. Laut offizieller Dokumentation erscheinen Anbieter, die nur konfiguriert, aber nicht aktiviert wurden, nicht in der Modellauswahlliste. Das ist die häufigste Ursache dafür, dass „der Schlüssel nicht funktioniert“.
- Rufen Sie die Modelle über Sync models ab, fügen Sie die gewünschten Modelle hinzu und prüfen Sie eines mit Check.
Adressen eingeben: nur die Basisadresse
Nach dem Quellcode von v2.1.4 geben Sie in jedes Feld nur die Basisadresse ein. Wenn der Versionsteil fehlt, wird /v1 automatisch angehängt (bei bereits vorhandener Version nicht); anschließend wird der feste Pfad für das jeweilige Feld ergänzt. Unter jedem Feld wird die endgültige URL unter „Request path“ angezeigt — prüfen Sie sie vor dem Speichern.
| Feld | Von Cherry Studio angehängter Pfad | Kunavo |
|---|---|---|
| OpenAI | /chat/completions | Unterstützt |
| Anthropic | /messages | Unterstützt |
| OpenAI Responses (More options) | /responses | Unterstützt |
| Image Generation Base URL (More options) | /images/generations | Unterstützt |
| Image Edit Base URL (More options) | /images/edits | Unterstützt |
| Gemini (More options) | /models/{model}:generateContent | Nicht unterstützt, leer lassen |
Es gibt zwei häufige Fehler. Wenn Sie die vollständige URL einschließlich /chat/completions oder /messages einfügen, wird der Pfad doppelt angehängt und ein 404-Fehler verursacht. Außerdem bedeutet das abschließende # gemäß dem Hinweis in der Oberfläche „Add # at the end to disable the automatically appended API version“, also ein Zeichen zum Deaktivieren der automatischen Versionsergänzung. Bei Standard-Endpoints führt dies dazu, dass /v1 fehlt. Um Adresse und Schlüssel selbst zu prüfen, ist der folgende Befehl am schnellsten.
curl https://api.kunavo.com/v1/models \
-H "Authorization: Bearer $KUNAVO_API_KEY"Grundlegende Modelleinstellungen zur Kostensenkung
Cherry Studio ruft auch außerhalb von Chats im Hintergrund Modelle auf. Quick Model wird laut Beschreibung für „einfache Aufgaben wie das Benennen von Unterhaltungen und das Extrahieren von Suchbegriffen“ verwendet; außerdem wird empfohlen, „ein leichtgewichtiges Modell zu wählen und Reasoning-Modelle zu vermeiden“. Wenn Sie hier ein günstiges Modell eintragen, wird nicht bei jeder Unterhaltung ein teures Modell ausgeführt. Auch Translate Model muss separat konfiguriert werden. Wenn Sie mehrere Modelle für eine Frage auswählen, werden entsprechend viele separate Requests gesendet und separat abgerechnet. Die Nutzungsstatistik der App ist ein in öffentliche Preise umgerechneter Schätzwert und fällt bei rabattierten Endpoints höher als die tatsächlichen Kosten aus. Tragen Sie in den Modelleinstellungen die tatsächlichen Preise ein, um dies zu korrigieren. Weitere Informationen finden Sie auf der englischen Seite Cherry Studio API cost.
Hinweise zur Nutzung mit Kunavo und zur Zahlung
- Prüfungsumfang: Diese Konfiguration wurde anhand des Cherry-Studio-Quellcodes und der offiziellen Dokumentation erstellt; Kunavo hat nicht verifiziert, dass Cherry Studio tatsächlich mit den eigenen Endpoints verbunden und ausgeführt wurde. Testen Sie mit dem aktuell verwendeten Pfad.
- Nur Chat und Bilder: Kunavo bietet keine Embedding-Modelle. Für die Vektorsuche in einer Wissensdatenbank benötigen Sie daher einen anderen Anbieter oder ein lokales Embedding-Modell. Die offizielle Dokumentation erklärt, dass die Wissensdatenbank auch ohne Embedding-Modell über die BM25-Schlüsselwortsuche funktioniert.
- MCP-Tools: Unter Settings → MCP Servers hinzugefügte Tools können nur mit Modellen verwendet werden, die Tool-Aufrufe unterstützen. Die oben hinzugefügten Claude- und GPT-Modelle unterstützen dies.
- Zahlung: Prepaid-Aufladung ohne monatliche Grundgebühr; das Guthaben wird tokenweise belastet. Der Mindestaufladebetrag beträgt $10, und beim Stripe-Checkout können Sie Karten (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay und Link verwenden. Wenn der Checkout in Won angezeigt wird, werden KakaoPay, Naver Pay, PAYCO, Samsung Pay sowie inländische Karten, für die internationale Zahlungen gesperrt sind, als Optionen angeboten (hinzugefügt am 3. Oktober 2026; bisher wurde noch keine Zahlung mit diesen Methoden vorgenommen). Die Beträge werden in US-Dollar festgelegt; Stripe rechnet die Anzeige in Won um, wobei der Wechselkurs eine vom Zahlenden zu tragende Umrechnungsgebühr von 2–4 % enthält. Toss Pay ist nicht verfügbar. Lesen Sie die Zahlungshinweise und erstellen Sie ein Konto, um einen Schlüssel auszustellen. Die englische Einstellungsseite ist der Cherry Studio integration guide.
Häufig gestellte Fragen
Wie konfiguriere ich die API in Cherry Studio?
Klicken Sie in Cherry Studio auf Settings → Model Provider → Add Provider, um den Dialog „Add Custom Provider“ zu öffnen. Geben Sie Provider Name und API Key ein, tragen Sie in den Feldern OpenAI und Anthropic unter Endpoint settings die Basisadresse ein und speichern Sie. Rufen Sie anschließend über „Sync models“ die Modellliste ab, fügen Sie die gewünschten Modelle hinzu und überprüfen Sie eines mit „Check“. Der Anbieter muss aktiviert (Enable) sein, damit Modelle in der Auswahlliste erscheinen.
Kann ich Cherry Studio auf Koreanisch verwenden?
Die UI unterstützt Koreanisch nicht. In v2.1.4 stehen 13 UI-Sprachen zur Verfügung: Englisch, Chinesisch (vereinfacht und traditionell), Japanisch, Deutsch, Französisch, Spanisch, Portugiesisch, Russisch, Griechisch, Rumänisch, Türkisch und Vietnamesisch. Da die Menüs häufig auf Englisch verwendet werden, übernehmen wir auf dieser Seite die englischen Menünamen unverändert. Die Gespräche mit den Modellen können Sie auf Koreanisch führen.
Muss ich /v1 an die API-Adresse anhängen?
Beides ist möglich. Der Quellcode von v2.1.4 fügt /v1 automatisch an die eingegebene Basisadresse an, wenn keine Version vorhanden ist, und lässt es unverändert, wenn es bereits enthalten ist. Anschließend werden die pfadspezifischen Endungen angehängt (OpenAI: /chat/completions, Anthropic: /messages). Vermeiden Sie es, die vollständige URL einschließlich /chat/completions einzufügen, da der Pfad sonst doppelt angehängt wird und ein 404-Fehler entsteht. Das abschließende # deaktiviert das automatische Hinzufügen der Version und sollte bei Standard-Endpoints nicht verwendet werden. Unter „Request path“ können Sie die endgültige URL prüfen.
Was tun, wenn nach Klick auf Sync models keine Modelle erscheinen?
Diese Schaltfläche fordert mit der eingegebenen Adresse und dem Schlüssel die Modellliste des Anbieters (/v1/models) an. Wenn sie leer bleibt, liegt das meist an der Adresse oder am Schlüssel. Prüfen Sie, ob Sie nicht die vollständige URL eingefügt haben und ob am Ende kein # steht, und führen Sie anschließend mit derselben Adresse und demselben Schlüssel einen curl-Aufruf aus. Wenn JSON zurückkommt, liegt das Problem bei der App; bei 401 liegt es am Schlüssel.
Ist Cherry Studio kostenlos?
Die Desktop-Community-Version ist als AGPL-3.0-Open-Source-Software kostenlos. Kosten entstehen für die Nutzung der Modelle des konfigurierten Anbieters. Cherry Studio Enterprise ist ein separates Produkt mit individueller Preisgestaltung, und das integrierte CherryAI ist kostenlos, aber Modellkonfiguration und Limits sind nicht öffentlich dokumentiert.
Überprüft am 1. Oktober 2026: GitHub-API (CherryHQ/cherry-studio, v2.1.4), Liste der UI-Übersetzungsdateien von v2.1.4 und englische UI-Zeichenfolgen (en-us.json), Quellcode des Anbieter-Dialogs und offizielle Cherry-Studio-Dokumentation. Kunavo hat Cherry Studio nicht mit den eigenen Endpoints ausgeführt.