Jedes Catalog-Modell als ein Provider in Cherry Studio.

Updated 2026-07-29

Die Model-Services-Einstellungen von Cherry Studio akzeptieren jeden OpenAI-kompatiblen Endpoint: Provider mit Typ OpenAI anlegen, API-Adresse auf api.apisrouter.com setzen, einen Key einfügen, Modell-IDs von Hand hinzufügen. Claude, GPT, DeepSeek, GLM, Kimi und Qwen sitzen in einem Picker auf dem Desktop.

Kurzantwort: ein Provider in Model Services.

Klicke auf das Zahnrad-Symbol in Cherry Studios linker Navigation, öffne den Tab Model Services und klicke auf den Add-Button unter der Provider-Liste. Gib dem Provider einen erkennbaren Namen (APIsRouter), wähle OpenAI als Provider-Typ und speichere. Wähle jetzt den neuen Provider in der Liste aus und konfiguriere ihn: aktiviere den Enable-Schalter, füge deinen Key in das API-Key-Feld ein und setze die API-Adresse auf https://api.apisrouter.com. Beachte die Form: Cherry Studios dokumentierter Standard ist es, die Root-Adresse zu nehmen und /v1/chat/completions selbst anzuhängen, also gibst du den Host ohne /v1 ein. Füge dann mit dem Add-Button im Modell-Abschnitt Modelle hinzu, eine exakte Catalog-ID pro Eintrag (claude-sonnet-4-6, deepseek-v4-flash, glm-5.2), und drücke den Check-Button neben dem Key, um eine Live-Validierung gegen ein ausgewähltes Modell auszuführen.

Provider name:  APIsRouter
Provider type:  OpenAI

then, on the provider page:
API key:        sk-YOUR-APISROUTER-KEY
API address:    https://api.apisrouter.com
                (Cherry appends /v1/chat/completions)
Models → + Add: claude-sonnet-4-6, deepseek-v4-flash, glm-5.2
Check → pick a model → success

Wie Cherry Studio die Request-URL zusammensetzt.

Cherry Studio (CherryHQ auf GitHub, rund 49K Stars) ist ein Desktop-Client chinesischen Ursprungs für Windows, macOS und Linux, bekannt für Presets für Hunderte Provider und Assistenten. Alles, was nicht in der Preset-Liste steht, kommt über den Custom-Provider-Flow oben herein, und das Feld, das man verstehen sollte, ist die API-Adresse. Der dokumentierte Standard: Du gibst die Root-Adresse an, und Cherry Studio hängt die OpenAI-Route selbst an, sodass aus https://api.apisrouter.com auf der Leitung https://api.apisrouter.com/v1/chat/completions wird. Nutzt ein Provider einen nicht standardmäßigen Pfad, deaktiviert ein # am Ende der Adresse die Verkettung komplett, und die Adresse wird exakt wie eingegeben verwendet — das ist der dokumentierte Notausgang. Das Verkettungsverhalten bei abschließenden Slashes hat sich zwischen Releases verschoben, also lies bei 404-Fehlern die finale URL aus der Fehlermeldung statt zu raten; die Root-Adresse-Form plus automatisches Anhängen ist die stabile Konfiguration für einen Standard-/v1-Gateway. Einmal konfiguriert, sendet jede Konversation Standard-Chat-Completions mit der hinzugefügten Modell-ID als reinem String. Für das Wire-Format spielt der Vendor keine Rolle, und genau das erlaubt es, chinesische und westliche Catalog-IDs in einem Provider-Eintrag zusammenzuführen.

Details, die sich lohnen: Multi-Key und Modell-Verwaltung.

Das API-Key-Feld akzeptiert mehr als einen Key: Keys mit englischen Kommas trennen, und Cherry Studio rotiert pro Anfrage von oben nach unten durch — ein dokumentiertes Load-Balancing-Feature. Bei einem Gateway, das pro Key misst, dient das zugleich als Zuordnung: ein Key für die Arbeit, einer privat, Rotation aus, indem nur einer gelistet wird. Modell-Einträge sind manuell, und das ist ein Feature. Cherry Studio zeigt genau das, was du hinzufügst, sodass der Picker kuratiert bleibt, statt in einem gefetchten Katalog zu ertrinken. Jeder Eintrag nimmt die ID als Wire-String; der Manage-Button bearbeitet oder entfernt Einträge später. Gruppiere verwandte IDs mit konsistenter Benennung, und der Picker liest sich wie eine Speisekarte: schnelle Stufe (deepseek-v4-flash, claude-haiku-4-5-20251001), regionale Stärke (glm-5.2, qwen3.7-plus, kimi-k2.6), Frontier (claude-sonnet-4-6). Der Check-Button validiert das Paar aus Key und Adresse gegen ein von dir gewähltes Modell, und das ist der schnellste Weg, den Provider vor echten Konversationen zu bestätigen. Ein fehlgeschlagener Check mit korrektem Key bedeutet fast immer, dass das Adressfeld ein überzähliges /v1 trägt, das den Pfad verdoppelt.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# add these ids verbatim in the provider's model list

Modellauswahl für den Desktop-Arbeitstier.

Ein Key bedeutet, dass Vergleiche Picker-Umschaltungen sind. Lass dieselbe Arbeitswoche auf zwei Kandidaten-IDs laufen und lass die Ausgaben pro Modell in der APIsRouter-Konsole gegen deinen eigenen Eindruck der Ausgabequalität entscheiden.

  • Alltäglicher Chat und schnelle Umformulierungen laufen auf der schnellen Stufe: deepseek-v4-flash und claude-haiku-4-5-20251001 halten das dauerhaft offene Fenster kostenlos anfühlend.
  • Chinesischsprachige Arbeit ist, wo die regionalen IDs ihre Zeile verdienen: glm-5.2 und qwen3.7-plus für Entwürfe und Dokumente, kimi-k2.6 für Long-Context-Lesen.
  • claude-sonnet-4-6 übernimmt die Konversationen, die du unbearbeitet weiterleitest: sorgfältige Analyse, kundenfähige Prosa, Code, den du ausliefern willst.
  • Cherry Studios Assistenten können ihr eigenes Modell pro Rolle pinnen, sodass ein Übersetzungs-Assistent auf glm-5.2 und ein Coding-Assistent auf claude-sonnet-4-6 hinter einem Provider koexistieren.
  • Füge Zeilen bewusst hinzu; ein kuratierter Sechs-Modell-Picker wird genutzt, während ein eingefügter Gesamtkatalog nur gescrollt wird.

Nutzungsbasiert · unter offiziellem Preis

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

ModellOffizieller PreisUnser Preis
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M
GLM-5.2$1.14 / $4.00 per M$1.10 / $4.00 per M
Kimi K2.6$0.95 / $4.00 per M$1.00 / $4.00 per M
Qwen 3.7 Plus$0.29 / $1.14 per M$0.30 / $1.10 per M

Fehlerbilder speziell für Cherry Studio.

Der verdoppelte Pfad ist die häufigste Meldung: https://api.apisrouter.com/v1 in ein Feld einzufügen, das /v1/chat/completions anhängt, erzeugt /v1/v1-URLs, die 404 liefern. Gib die Root-Adresse ein und lass den Client die Route bauen. Musst du eine exakte URL fixieren, existiert dafür die abschließende #-Form. Ein fehlgeschlagener Check mit gutem Key ist meist die obige Adressform; ein fehlgeschlagener Check mit sauberer Adresse ist der Key — und beachte, dass mehrere Keys mit englischen Kommas getrennt werden müssen, da Vollbreiten-Zeichen aus chinesischen Eingabemethoden die Liste lautlos zerstören. Wenn einzelne Modelle Fehler werfen, während andere funktionieren, ist das ein Schreibfehler in der ID; Einträge sind Freitext, und die /v1/models-Liste ist die maßgebliche Quelle. Und denk daran: Einstellungen gelten pro Rechner — ein auf deinem Desktop konfigurierter Provider existiert auf deinem Laptop erst, wenn du das Zwei-Minuten-Setup wiederholst oder Cherry Studios eigene Backup-Funktionen nutzt. Hinweis zu Versionsdrift: Cherry Studio erscheint häufig in neuen Versionen, und Einstellungs-Labels wandern (Model Services taucht in manchen Builds auch als Model Provider auf); der Ablauf aus Provider hinzufügen, OpenAI-Typ wählen, Key, Adresse, Modelle ist stabil geblieben.

Wer Cherry Studio über ein Gateway leitet.

  • Zweisprachige Desktop-Nutzer, die GLM, Qwen, Kimi und DeepSeek mit Claude und GPT in einem Picker mischen, ein Guthaben, keine Konten pro Vendor.
  • Nutzer in Asien, die Claude- und GPT-IDs auf einem Prepaid-Guthaben ohne westliche Karte wollen, neben den regionalen Modellen, die sie bereits nutzen.
  • Power-User, die Cherry-Studio-Assistenten pro Rolle betreiben und jeden Assistenten am richtigen Vendor pinnen wollen, ohne fünf Keys zu verwalten.
  • Leute, die bereits andere Tools über ein Gateway leiten und den Desktop-Client auf demselben Key und Nutzungslog wollen.
  • Jeder, der regionale und westliche Modelle bei echter Alltagsarbeit statt anhand von Benchmarks vergleicht, wo jeder Kandidat eine Modellzeile ist.

Endpoint prüfen und die erste Konversation debuggen.

Curl zuerst die Modell-Liste und kopiere die IDs, die du hinzufügen willst; führe dann eine Chat-Completion gegen deinen geplanten Alltags-Treiber aus. Bestehen beide, liegt alles Übrige auf der Provider-Seite. Führe in Cherry Studio Check vor dem Chatten aus. Authentifizierungsfehler liegen am Key-Feld oder seinen Komma-Trennzeichen. 404er sind die Adressform — lies die zusammengesetzte URL in der Fehlermeldung und zähle die /v1-Segmente. Not-Found-Fehler bei einem bestimmten Modell sind ein Schreibfehler in dieser Zeile. Sobald Konversationen laufen, zeigt die APIsRouter-Konsole Modell, Token-Zahlen und Ausgaben pro Anfrage. Ein über einen Arbeitstag genutzter Desktop-Client erzeugt einen stetigen Strom kleiner Anfragen, und die Nutzungsansicht pro Key macht daraus Zahlen pro Modell, pro Tag, mit chinesischen und westlichen IDs auf derselben Seite.

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash",
       "messages":[{"role":"user","content":"ping"}]}'

Häufige Fragen

Wie füge ich in Cherry Studio einen Custom Provider hinzu?

Zahnrad-Symbol, Tab Model Services, Add. Provider benennen, Typ OpenAI wählen, speichern, dann auf seiner Seite aktivieren, Key einfügen, API-Adresse auf https://api.apisrouter.com setzen und Modell-IDs manuell hinzufügen. Mit dem Check-Button validieren.

Sollte die API-Adresse /v1 enthalten?

Nein. Cherry Studios dokumentierter Standard nimmt die Root-Adresse und hängt /v1/chat/completions selbst an, also https://api.apisrouter.com eingeben. Ein /v1-Host einzufügen verdoppelt den Pfad und liefert 404. Um eine exakte, nicht standardmäßige URL zu fixieren, die Adresse mit # abschließen, um die Verkettung zu deaktivieren.

Kann Cherry Studio Claude, DeepSeek und GLM über einen Provider betreiben?

Ja. Die ID jeder Modellzeile geht als reiner String an die Adresse, sodass claude-sonnet-4-6, deepseek-v4-flash, glm-5.2, kimi-k2.6 und qwen3.7-plus sich einen Provider-Eintrag und einen Key teilen können, umschaltbar pro Konversation und pro Assistent.

Was macht das Komma-getrennte-Key-Feature?

Mehrere Keys im API-Key-Feld, getrennt durch englische Kommas, werden über Anfragen hinweg von oben nach unten rotiert — ein eingebautes Load-Balancing-Feature. Mit Metering pro Key auf der Gateway-Seite funktioniert das auch als Zuordnung; einen einzelnen Key listen, um die Rotation auszuschalten.

Warum schlägt der Check-Button fehl?

Bei korrektem Key ist die übliche Ursache eine Adresse mit überzähligem /v1, das den zusammengesetzten Pfad verdoppelt. Bei sauberer Adresse den Key und seine Trennzeichen erneut prüfen; Vollbreiten-Kommas aus chinesischen Eingabemethoden zerstören Multi-Key-Listen lautlos.

Warum füllen sich Modelle nicht automatisch wie bei Preset-Providern?

Custom Provider listen exakt das, was du hinzufügst; Cherry Studio fetcht den Katalog eines Custom Endpoints nicht. Das hält den Picker kuratiert. Zieh IDs aus der /v1/models-Liste und füge die hinzu, die du tatsächlich nutzt, dann erweiterst du die Liste an dem Tag, an dem du eine weitere brauchst.