Cherry Studio mit CheapTokens verbinden: benutzerdefinierter Anbieter, Base URL

Um CheapTokens in Cherry Studio zu nutzen, füge einen benutzerdefinierten Anbieter hinzu (Einstellungen → Modellanbieter → Anbieter hinzufügen), trage https://api.cheaptokens.dev/v1/ in das Feld OpenAI Base URL ein, füge deinen API-Schlüssel ein und ergänze die Modell-ID deepseek-ai/DeepSeek-V4-Flash-0731 manuell. Prüfe dann den Schlüssel mit Model Check und sag Hallo. Das ist die ganze Arbeit; das einzige Detail, das beißt, ist der Schrägstrich am Ende der URL.

Du öffnest eine Desktop-Chat-App, weil du ein Fenster für mehrere Modelle und ein Guthaben dahinter willst, nicht einen Browser-Tab pro Dienst. Cherry Studio ist dafür gebaut: eine Open-Source-KI-Workstation für Windows, macOS und Linux (AGPL-3.0 Community Edition) mit Chat, Agents und Wissensdatenbanken, die jeden OpenAI-kompatiblen Dienst als benutzerdefinierten Anbieter akzeptiert. CheapTokens spricht das OpenAI-Chat-Completions-Format, also passt es. Die folgenden Schritte folgen der Cherry-Studio-Dokumentationsseite zu benutzerdefinierten Anbietern, geprüft am 7. November 2026; die App selbst ändert sich, wenn also eine Bezeichnung verschoben wurde, suche in der Nähe nach demselben Wort.

Was du brauchst, bevor du die App öffnest#

Drei Dinge, alle kurz:

• die Base URL: https://api.cheaptokens.dev/v1/ (mit dem abschließenden Schrägstrich — der Grund steht im nächsten Abschnitt);
• einen API-Schlüssel aus deinem CheapTokens-Konto, aufbewahrt an einem Ort, von dem du ihn kopieren kannst, nicht in eine geteilte Notiz eingefügt;
• die vollständige Modell-ID. Der Kurzname aus der Preisliste wird von der API nicht akzeptiert; verwende die Gateway-ID, zum Beispiel deepseek-ai/DeepSeek-V4-Flash-0731. Die anderen IDs stehen im list-models-Leitfaden und in der CheapTokens-Dokumentation.

Den benutzerdefinierten Anbieter hinzufügen#

Öffne die Einstellungen (das Zahnrad-Symbol), dann Modellanbieter. Unten in der Anbieterliste steht + Anbieter hinzufügen. Klicke darauf, und der Dialog Benutzerdefinierten Anbieter hinzufügen erscheint.

Fülle ihn so aus:

Cherry Studio zeigt standardmäßig Endpunkt-Felder für 'OpenAI' und 'Anthropic'. Fülle nur das Protokoll aus, das du tatsächlich verwendest; für einen normalen Chat ist das das OpenAI-Feld, und das Anthropic-Feld kann leer bleiben. Unter jedem Base-URL-Feld zeigt die App eine Vorschau des endgültigen Anfragepfads. Lies sie. Das ist der schnellste Weg, eine falsche Adresse zu erkennen, bevor du etwas sendest.

Klicke auf Hinzufügen, um zu speichern.

Warum der abschließende Schrägstrich wichtig ist#

Cherry Studio baut die Anfrage-URL aus deiner Base URL nach drei Regeln in seiner Dokumentation (geprüft am 7. November 2026):

• an eine Stammadresse wie https://example.com wird /v1/chat/completions angehängt;
• an eine Adresse, die mit / endet, wird nur chat/completions angehängt;
• eine Adresse, die mit # endet, wird genau so verwendet, wie sie eingegeben wurde, ohne dass etwas angehängt wird.

CheapTokens liegt unter /v1, also ist https://api.cheaptokens.dev/v1/ die Form, die zu https://api.cheaptokens.dev/v1/chat/completions wird — der Pfad, den die API erwartet. Die Vorschau unter dem Feld sollte genau das anzeigen. Wenn du /v1/v1/ siehst oder gar kein /v1, korrigiere das Feld, bevor du weitermachst.

Schlüssel, Modell und Model Check#

Zurück auf der Seite des Anbieters gibt es fünf kleine Schritte. Führe sie in dieser Reihenfolge aus:

Ein Hinweis zu Schritt 5. Die Seite hat auch eine Schaltfläche Modelle synchronisieren, die eine Modellliste vom Dienst abruft. Der zuverlässige Weg ist, die ID selbst mit + hinzuzufügen: Tippe deepseek-ai/DeepSeek-V4-Flash-0731 genau ein, mit dem Teil deepseek-ai/. Welche Modelle du hinzufügen kannst:

Model Check ist die Schaltfläche neben dem Schlüsselfeld; laut der Cherry-Studio-Dokumentation prüft sie, ob der Schlüssel gültig ist. Wenn sie sich beschwert, springe zum Fehlerabschnitt unten: die Ursache ist meistens eines von drei Feldern.

Die erste Nachricht senden#

Öffne einen neuen Chat, wähle den CheapTokens-Anbieter und das Modell, das du hinzugefügt hast, im Modellauswähler oben aus und schreibe etwas Kurzes, wie 'Erkläre in zwei Sätzen, was ein Token ist.' Eine Antwort des Modells bedeutet, dass die ganze Kette funktioniert: Schlüssel, Adresse, Modell-ID.

Willst du eine Anfrage ohne die App sehen? Hier ist ein einfacher Chat-Completions-Aufruf:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-ai/DeepSeek-V4-Flash-0731", "messages": [{"role": "user", "content": "Explain what a token is in two sentences."}]}'

Die Antwort ist JSON mit dem Text in choices[0].message.content und den Token-Zahlen in usage.

Welches Modell in einen Desktop-Chat gehört#

Ein Chat-Fenster ist eine andere Aufgabe als eine Agent-Schleife: du fragst, liest, fragst wieder. Dann zählen zwei Dinge: wie lang die Antworten sein können und wie groß ein Gespräch passt.

• DeepSeek-V4-Flash — die Standardwahl für allgemeinen Chat und lange Dokumente: bis zu 32.768 Ausgabe-Tokens pro Antwort, 380K Kontext, ein Preis zu jeder Stunde. Insgesamt, mit Eingabe und Ausgabe zusammen gerechnet, ist es günstiger als OpenRouter.
• GLM-5.3-Flash — Alltags-Chat mit dem größten Fenster der drei (390K), günstiger als OpenRouter bei Eingabe und Ausgabe.
• MiniMax-M2.7 — Chat und Agent-artige Aufgaben mit einem 180K-Kontext, günstiger als OpenRouter auf beiden Seiten.

Alle drei liegen hinter einem Guthaben, also kannst du alle drei IDs zum selben Anbieter hinzufügen und im Modellauswähler wechseln, ohne den Schlüssel anzufassen.

Was eine Chat-Sitzung kostet#

Hier ist ein grobes Bild. Sagen wir, du hast eine Unterhaltung mit 20 Nachrichten. Jede Nachricht sendet den bisherigen Verlauf erneut, also hat eine Anfrage im Durchschnitt etwa 6.000 Tokens Eingabe und 500 Tokens Ausgabe (ein Grund, der in warum ein langer Chat mehr kostet behandelt wird). Eine Anfrage auf DeepSeek-V4-Flash kostet $0.00014. Zwanzig davon stehen im Rechner unten; verschiebe die Schieberegler, um sie an deine eigenen Chats anzupassen.

Die Tabelle unten führt dieselbe Sitzung auf allen Modellen aus, mit einer OpenRouter-Spalte zum Vergleich:

Aktuelle Preise pro 1M Tokens findest du unter CheapTokens-Preise.

Wenn es nicht funktioniert#

Die meisten Probleme kommen von denselben drei Feldern: Schlüssel, URL, Modell-ID. Ordne das, was du siehst, der Ursache zu:

Für eine ausführlichere Erklärung dieser Fehler siehe API 401 oder 404: falscher Schlüssel, falsche Base URL oder Modell-ID. Und wenn du einen browserbasierten Chat statt einer Desktop-App bevorzugst, funktioniert Open WebUI auf dieselbe Weise.

Quellen: Cherry-Studio-Dokumentation, Seiten zu benutzerdefinierten Anbietern und Anbietereinstellungen, geprüft am 7. November 2026; das Projekt ist unter github.com/CherryHQ/cherry-studio.