Cherry-Studio-API-Einstellungen — Anbieter, Adresse und Schlüssel

Um eine eigene API in Cherry Studio einzurichten, gehe zu 設定 → 模型供應商 → 新增供應商: Trage den API-Schlüssel ein, füge in den Feldern OpenAI und Anthropic unter „端點設定“ jeweils eine Basis-URL ein, speichere, klicke auf „同步模型“, um die Modelle abzurufen, und prüfe anschließend mit „檢查“, ob es funktioniert. Dieser Beitrag basiert auf v2.1.4, veröffentlicht am 30. September 2026; alle Menünamen werden im Originalwortlaut der traditionell-chinesischen Cherry-Studio-Oberfläche wiedergegeben. v2 hat den Bildschirm zum Hinzufügen eines Anbieters grundlegend geändert; Anleitungen aus der v1-Zeit mit „OpenAI als Typ auswählen“ passen nicht mehr dazu.

Diese Seite bezieht sich auf die Desktop-Version von CherryHQ/cherry-studio (AGPL-3.0, unterstützt Windows, macOS und Linux). Bei der Überprüfung am 1. Oktober 2026 war das Repository nicht archiviert; die neueste Version war v2.1.4. Die gleichnamige App im App Store stammt von einem anderen Entwickler und ist ein nicht damit verbundenes Produkt. Außerdem ist die offizielle Dokumentation von Cherry Studio auf vereinfachtem Chinesisch. Nach dem Umschalten der Oberfläche auf traditionelles Chinesisch wird „提供商／服務商“ als „供應商“ angezeigt; lass dich beim Abgleich mit der Dokumentation nicht durch die Bezeichnungen verwirren.

Schrittweise Einrichtung

Cherry Studio v2.1.4 (traditionell-chinesische Benutzeroberfläche)

設定 → 模型供應商 → 新增供應商
  （對話框標題：新增自訂供應商）

  供應商名稱                 Kunavo
  API 金鑰                   sk-kn-...
  端點設定
    OpenAI Chat Completions  https://api.kunavo.com/v1
    Anthropic Messages       https://api.kunavo.com
  更多選項
    OpenAI Responses         https://api.kunavo.com/v1   （選填）
    影像產生基礎 URL           https://api.kunavo.com/v1   （選填）
    Google Gemini            留空

→ 儲存 → 在模型清單按「同步模型」→ 加入要用的模型 → 「檢查」

Öffne Einstellungen → Modellanbieter und klicke auf Anbieter hinzufügen. Der erscheinende Dialog trägt den Titel „Benutzerdefinierten Anbieter hinzufügen“. Bei Coding-Plan-Diensten, mehreren Konten oder einer Trennung nach Projekten kannst du oben über „Mit Voreinstellung beginnen (optional)“ eine vorhandene Voreinstellung verwenden.
Trage Anbietername und API-Schlüssel ein.
Unter Endpunkteinstellungen gibt es standardmäßig die beiden Felder OpenAI Chat Completions und Anthropic Messages; mindestens ein Text-Endpunkt muss konfiguriert werden. Wenn du beide ausfüllst, können auch Agenten außerhalb des Chats und Funktionen im Anthropic-Format ein Modell auswählen.
Klappe Weitere Optionen auf. Dort gibt es außerdem OpenAI Responses, Google Gemini, die Basis-URL für Bildgenerierung und die Basis-URL für Bildbearbeitung. Nicht benötigte Felder können leer bleiben.
Stelle nach dem Speichern sicher, dass dieser Anbieter den Status Aktiviert hat. Laut offizieller Dokumentation erscheinen Modelle eines konfigurierten, aber nicht aktivierten Anbieters nicht im Menü — dies ist die häufigste Ursache dafür, dass der „Schlüssel nicht reagiert“.
Klicke in der Modellliste auf Modelle synchronisieren, füge die gewünschten Modelle hinzu und klicke anschließend auf Prüfen, um eines zu testen.

Adressen eintragen: nur die Basis-URL

Laut dem Quellcode von v2.1.4 wird in jedes Feld eine Basis-URL eingetragen: Wenn kein Versionssegment vorhanden ist, wird /v1 automatisch ergänzt (bei vorhandenem Segment nicht), anschließend folgt der feste Pfad des jeweiligen Feldes. Unter jedem Feld wird der „Anforderungspfad“ angezeigt; das ist die endgültig gesendete URL.

Feld	Von Cherry Studio angehängter Pfad	Kunavo
OpenAI Chat Completions	`/chat/completions`	Unterstützt
Anthropic Messages	`/messages`	Unterstützt
OpenAI Responses (Weitere Optionen)	`/responses`	Unterstützt
Basis-URL für Bildgenerierung (Weitere Optionen)	`/images/generations`	Unterstützt
Basis-URL für Bildbearbeitung (Weitere Optionen)	`/images/edits`	Unterstützt
Google Gemini (Weitere Optionen)	`/models/{model}:generateContent`	Nicht unterstützt, leer lassen

Zwei häufige Fehler: Erstens wird eine vollständige URL eingefügt, die /chat/completions oder /messages enthält; der Pfad wird doppelt angehängt und 404 zurückgegeben. Zweitens wird am Ende # ergänzt. Der Hinweis der Oberfläche ist eindeutig: „Am Ende # hinzufügen, um das automatische Anhängen der API-Version zu deaktivieren.“ Bei Standardendpunkten verschwindet dadurch /v1.

Richtig einrichten, Rechnung reduzieren

Cherry Studio ruft neben Chats auch im Hintergrund Modelle auf. Das Schnellmodell dient laut Beschreibung der Oberfläche „zum Benennen von Unterhaltungen, Extrahieren von Suchbegriffen usw. für einfache Aufgaben“; außerdem steht dort: „Bitte wählen Sie ein leichtgewichtiges Modell und vermeiden Sie Reasoning-Modelle.“ Wenn du hier ein günstiges Modell einträgst, läuft nicht bei jeder Unterhaltung einmal das teure Modell. Auch das Übersetzungsmodell wird separat konfiguriert. Wenn du mehrere Modelle gleichzeitig befragst, wird pro Modell jeweils eine Anfrage gesendet und jeweils einmal berechnet. Die in der App angezeigten Nutzungsstatistiken sind ein aus öffentlichen Preisen berechneter Schätzwert und fallen bei einer rabattierten Route zu hoch aus; ändere in den Modelleinstellungen den Einzelpreis auf deinen tatsächlichen Preis, dann stimmt der Wert. Weitere Einzelheiten findest du im englischen Cherry Studio API cost.

Hinweise zur Nutzung von Kunavo und zur Zahlung in Taiwan

Geltungsbereich der Prüfung: Die obige Einrichtung wurde aus dem Quellcode und der offiziellen Dokumentation von Cherry Studio zusammengestellt; Kunavo hat Cherry Studio nicht tatsächlich mit eigenen Endpunkten betrieben. Behalte deine aktuell funktionierende Route bei und teste diese zusätzlich.
Nur Chat und Bilder: Kunavo bietet keine Embedding-Modelle. Für die Vektorsuche der Wissensdatenbank musst du einen anderen Anbieter oder ein lokales Embedding-Modell verwenden; laut offizieller Dokumentation funktioniert die Wissensdatenbank ohne Embedding-Modell weiterhin mit BM25-Schlüsselwortsuche.
MCP-Tools: Für Tools, die unter Einstellungen → MCP-Server hinzugefügt werden, muss das verwendete Modell Tool Calling unterstützen; die oben hinzugefügten Claude- und GPT-Modelle unterstützen dies.
Zahlung: Prepaid-Aufladung, Abrechnung nach Token, keine Monatsgebühr. Mindestaufladung $10, Checkout über Stripe, in Taiwan verfügbare Kreditkarten (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay und Link; JKOPAY und LINE Pay sind nicht verfügbar. Siehe Abrechnungsinformationen; sobald Sie bereit sind, können Sie ein Konto erstellen und einen Schlüssel generieren. Die englische Einstellungsseite ist der Cherry-Studio-Integrationsleitfaden.

Häufig gestellte Fragen

Wie richtet man eine eigene API in Cherry Studio ein?

Gehe zu Einstellungen → Modellanbieter → Anbieter hinzufügen, öffne den Dialog „Benutzerdefinierten Anbieter hinzufügen“, trage Anbietername und API-Schlüssel ein und füge in den Endpunkteinstellungen in den Feldern OpenAI Chat Completions und Anthropic Messages die Basis-URL ein. Speichere anschließend, klicke in der Modellliste auf „Modelle synchronisieren“, füge die gewünschten Modelle hinzu und bestätige mit „Prüfen“, dass eines davon funktioniert. Der Anbieter muss aktiviert sein, sonst erscheint das Modell nicht im Menü.

Muss die API-Adresse von Cherry Studio /v1 enthalten?

Beides ist möglich. Der Quellcode von v2.1.4 ergänzt hinter der von dir eingegebenen Basis-URL automatisch die Version (/v1), sofern sie nicht bereits vorhanden ist; danach wird der eigene Pfad des Feldes angehängt (OpenAI: /chat/completions, Anthropic: /messages). Vermeiden musst du eine vollständige URL einschließlich /chat/completions, da der Pfad sonst doppelt vorkommt und 404 zurückgegeben wird. Ein abschließendes # dient dazu, „automatisches Anhängen der API-Version deaktivieren“; bei Standardendpunkten darf es nicht ergänzt werden. Unter jedem Feld wird der „Anforderungspfad“ angezeigt, sodass du vor dem Speichern die endgültige URL prüfen kannst.

Was tun, wenn „Modelle synchronisieren“ keine Modelle abruft?

Diese Schaltfläche verwendet die eingegebene Adresse und den Schlüssel, um die Modellliste des Anbieters (/v1/models) abzurufen. Ist die Liste leer, liegt es meist an Adresse oder Schlüssel und nicht an Cherry Studio. Prüfe zunächst, dass keine vollständige URL eingefügt wurde und am Ende kein # steht. Teste anschließend dieselbe Adresse und denselben Schlüssel mit curl: Eine JSON-Antwort bedeutet, dass das Problem in der App liegt; 401 bedeutet, dass der Schlüssel falsch ist.

Kann Cherry Studio auf traditionelles Chinesisch umgestellt werden?

Ja. Die Benutzeroberfläche von Cherry Studio enthält 13 Sprachen, darunter traditionelles Chinesisch (zh-TW); du kannst dies in den Spracheinstellungen umstellen. Beachte, dass die traditionelle Oberfläche Dienstanbieter als „供應商“ bezeichnet, während offizielle Dokumentation und die vereinfachte Oberfläche „提供商“ bzw. „服務商“ schreiben. Beim Abgleich von Anleitungen unterscheiden sich die Namen, bezeichnen aber dasselbe.

Kostet Cherry Studio etwas?

Die Desktop-Version (Community-Version) ist Open-Source-Software unter AGPL-3.0 und kostenlos. Kosten entstehen für die Modellnutzung des von dir konfigurierten Anbieters. Cherry Studio Enterprise ist ein separat bepreistes kommerzielles Produkt; CherryAI ist integriert und kostenlos, aber Modellangebot und Kontingent sind nicht öffentlich.

Überprüft am 1. Oktober 2026: GitHub API (CherryHQ/cherry-studio, v2.1.4), die traditionell-chinesischen UI-Strings von v2.1.4 (zh-tw.json), der Quellcode des Bildschirms zum Hinzufügen eines Anbieters und die offizielle Dokumentation von Cherry Studio. Kunavo hat eigene Endpunkte nicht tatsächlich mit Cherry Studio betrieben.