Wenn Sie nach dem Cherry Studio API-Setup suchen, wissen Sie wahrscheinlich bereits, welchen Model-Router Sie verwenden möchten. Die verbleibende Aufgabe ist praktisch: Fügen Sie in Cherry Studio einen Anbieter hinzu, geben Sie den richtigen API-Schlüssel ein, setzen Sie die API-Adresse, fügen Sie die gewünschten Modell-IDs hinzu und bestätigen Sie, dass der Anbieter aktiviert ist.
Flatkey passt zu diesem Workflow, weil es Cherry-Studio-Nutzern eine OpenAI-kompatible Zugriffsebene für unterstützte Modelle bietet. Anstatt für jede Modellfamilie separate Anbieter-Konten zu erstellen, können Sie einen Flatkey-API-Schlüssel, die Flatkey-Router-Basis-URL und das Flatkey-Dashboard für Nutzung, Abrechnung, Modellauswahl und Routing-Überprüfung verwenden.
Dieser Leitfaden zeigt das Cherry Studio API-Setup über Flatkey als textbasierten Workflow. Er folgt der aktuellen Dokumentation von Cherry Studio für benutzerdefinierte Anbieter und verzichtet auf App-Screenshots, da die Screenshots für diese Veröffentlichung nicht von den Prüfern bestätigt wurden.
Schnelle Antwort: Cherry Studio API-Einstellungen für Flatkey
Für ein Standard-Cherry Studio API-Setup mit Flatkey fügen Sie einen benutzerdefinierten Anbieter hinzu und wählen Sie OpenAI als Anbietertyp. Geben Sie dann Ihren Flatkey-API-Schlüssel ein, setzen Sie die API-Adresse auf die OpenAI-kompatible Router-Basis-URL von Flatkey, fügen Sie die Modell-IDs hinzu, die Sie verwenden möchten, führen Sie die Cherry-Studio-Prüfung aus und aktivieren Sie den Anbieter-Schalter.
| Cherry Studio Field | Flatkey Value | What To Verify |
|---|---|---|
| Provider Name | Flatkey |
Ein eindeutiger Name ist in Ordnung. Verwenden Sie einen Namen, den Ihr Team später wiedererkennt. |
| Provider Type | OpenAI |
Cherry Studio dokumentiert OpenAI als unterstützten Typ für benutzerdefinierte Anbieter. |
| API Key | Your Flatkey API key | Erstellen Sie den Schlüssel oder kopieren Sie ihn aus dem Flatkey-Dashboard. Veröffentlichen Sie ihn nicht und fügen Sie ihn nicht in gemeinsam genutzte Dokumente ein. |
| API Address | https://router.flatkey.ai/v1 |
Verwenden Sie die OpenAI-kompatible Flatkey-Basis-URL. Fügen Sie keinen vollständigen /chat/completions-Endpunkt ein. |
| Models | Model IDs from Flatkey | Verwenden Sie den Flatkey-Preiskatalog oder die Konsole als maßgebliche Quelle vor dem Produktionseinsatz. |
| Check | Use Cherry Studio's check button | Wenn die Prüfung fehlschlägt, überprüfen Sie den Schlüssel, die API-Adresse, die Modellliste und den Aktivierungsstatus des Anbieters. |
Wenn Ihr Cherry-Studio-Build ausdrücklich nach der Root-API-Adresse fragt und automatisch /v1/chat/completions anhängt, verwenden Sie stattdessen https://router.flatkey.ai. In der eigenen API-Adressdokumentation von Cherry Studio steht, dass die App bei üblichen Large-Language-Model-Routen möglicherweise den standardmäßigen Chat-Completions-Pfad anhängt, und außerdem wird ein #-Suffix für vollständige benutzerdefinierte Routen dokumentiert. Beginnen Sie für Flatkey mit der veröffentlichten Basis-URL und nutzen Sie dann das Prüfergebnis, um ein mögliches Adressformat-Mismatch zu erkennen, bevor Sie echte Arbeit senden.
Warum Flatkey für den Cherry Studio API-Zugriff verwenden
Ein Cherry Studio API-Setup geht in der Regel nicht nur darum, eine einzelne Chat-Antwort zu erhalten. Es geht darum, einen Desktop-KI-Client mit den Modellen verbunden zu halten, die Ihr Team tatsächlich nutzt: GPT-ähnliche Modelle, Gemini-kompatible Modelle, DeepSeek, Qwen, Bildmodelle und andere unterstützte Routen.
Die öffentliche Produktoberfläche von Flatkey ist genau für dieses Zugriffsmuster konzipiert:
- Ein API-Schlüssel für verbundene KI-Modelle.
- Eine OpenAI-kompatible Basis-URL:
https://router.flatkey.ai/v1. - Ein Dashboard für Schlüssel, Nutzung, Abrechnung und Routing.
- Ein Modellkatalog mit aktueller Verfügbarkeit und Preissignalen.
- Öffentlicher Tool-Kontext, der Cherry Studio als unterstützte App nennt.
Das macht den Cherry Studio API-Workflow für Entwickler sauberer, die einen Desktop-Client und eine Modellzugriffsschicht wollen, ohne jeden Modelltest in ein separates Provider-Konto-Setup zu verwandeln.
Bevor Sie beginnen
Bevor Sie die Einstellungen von Cherry Studio ändern, bestätigen Sie diese Punkte:
- Sie können sich bei Flatkey anmelden und auf das Dashboard zugreifen.
- Sie haben einen Flatkey-API-Schlüssel erstellt oder können einen erstellen.
- Ihr Flatkey-Konto verfügt über Guthaben oder Zugriff für die Modelle, die Sie testen möchten.
- Sie kennen mindestens eine Modell-ID aus der Flatkey-Konsole oder dem Preiskatalog.
- Sie können die Cherry-Studio-Einstellungen öffnen und Model Services bearbeiten.
Verwenden Sie für den ersten Smoke-Test der Cherry Studio API keinen Produktionsschlüssel, wenn Ihr Team getrennte Entwicklungs- und Produktionsanmeldedaten verwendet. Verwenden Sie einen eingeschränkten Testschlüssel, überprüfen Sie die Route und entscheiden Sie dann, wie Sie Schlüssel für die tägliche Desktop-Nutzung verwalten möchten.
Schritt 1: Einen Flatkey-API-Schlüssel erstellen oder kopieren
Öffnen Sie das Flatkey-Dashboard und erstellen Sie einen API-Schlüssel für Cherry Studio. Benennen Sie ihn eindeutig, etwa cherry-studio-desktop, damit sich spätere Nutzungsprotokolle leichter interpretieren lassen.
Wenn Ihr Team gemeinsam genutzte Arbeitsstationen oder mehrere Entwickler verwendet, erstellen Sie separate Schlüssel statt eines gemeinsam genutzten Secrets. Das macht den Nutzungsverlauf der Cherry Studio API einfacher zu überprüfen und sicherer zu widerrufen, falls jemand das Projekt verlässt.
Speichern Sie den Schlüssel in Ihrem Passwort-Manager oder Team-Secret-Manager. Sie müssen ihn während der Einrichtung nur einmal in das API-Key-Feld von Cherry Studio einfügen.
Schritt 2: Einen benutzerdefinierten Provider in Cherry Studio hinzufügen
Die aktuelle Dokumentation von Cherry Studio zum benutzerdefinierten Provider beschreibt diesen Ablauf:
- Öffnen Sie Cherry Studio.
- Öffnen Sie Einstellungen.
- Gehen Sie zu Model Services.
- Klicken Sie unter der Provider-Liste auf + Add.
- Setzen Sie Provider Name auf
Flatkey. - Setzen Sie Provider Type auf
OpenAI. - Klicken Sie auf Add.
Dadurch wird die Provider-Hülle erstellt. Die Einrichtung der Cherry Studio API ist damit noch nicht abgeschlossen, bis der API-Schlüssel, die API-Adresse, die Modellliste, die Prüfung und der Aktivierungsschalter konfiguriert sind.
Schritt 3: Geben Sie den Flatkey-API-Schlüssel und die API-Adresse ein
Nachdem Sie den Anbieter hinzugefügt haben, wählen Sie ihn in der Anbieterliste aus und füllen Sie die Hauptfelder aus.
| Feld | Was einzugeben ist | Häufiger Fehler |
|---|---|---|
| API-Schlüssel | Fügen Sie Ihren Flatkey-API-Schlüssel ein. | Verwenden eines Anbieter-Schlüssels von OpenAI, Anthropic, Google oder einem anderen Dienst anstelle des Flatkey-Schlüssels. |
| API-Adresse | Verwenden Sie https://router.flatkey.ai/v1 als OpenAI-kompatible Basis-URL. |
Einfügen von https://router.flatkey.ai/v1/chat/completions, als ob Cherry Studio den vollständigen Endpunkt wollte. |
| Aktivieren | Schalten Sie den Anbieter-Schalter ein, nachdem die Prüfung erfolgreich war. | Die Prüfung besteht, aber der Anbieter bleibt deaktiviert, wodurch die Modelle aus der Modellliste ausgeblendet werden. |
Die API-Adresse-Dokumentation von Cherry Studio weist darauf hin, dass sich vollständige Routen anders verhalten können als Basisadressen. Für diesen Cherry Studio API-Workflow ist die sichere Vorgehensweise einfach: Verwenden Sie zuerst die Basis-URL von Flatkey, hängen Sie den Chat-Completions-Endpunkt nicht selbst an, und lassen Sie die Prüfung anzeigen, ob Ihre Cherry-Studio-Version eine Variante der Root-Adresse erwartet.
Schritt 4: Flatkey-Modell-IDs hinzufügen
Cherry Studio kann Modelle aus den Anbieter-Einstellungen abrufen oder verwalten, aber die Modell-ID bleibt wichtig. Wenn das Modell nicht zur Modellliste des Anbieters hinzugefügt wurde, wird es später möglicherweise nicht im Modellauswahlfeld von Cherry Studio angezeigt.
Verwenden Sie die Flatkey-Konsole oder den Preiskatalog als aktuelle Quelle für Modell-IDs. Ein datierter Snapshot der Pricing-API für diesen Artikel ergab Unterstützung für OpenAI-kompatible Endpunkte im gesamten Flatkey-Katalog, einschließlich Modellnamen wie deepseek-chat, gpt-4.1, qwen-max und andere OpenAI-kompatible Einträge. Betrachten Sie diese Beispiele als datierten Nachweis, nicht als dauerhafte Empfehlungsliste.
Wählen Sie für den ersten Cherry Studio API-Smoke-Test ein Modell aus, auf das Ihr Konto zugreifen kann und das für Chat vorgesehen ist. Fügen Sie zunächst nur dieses Modell hinzu. Nachdem die Prüfung bestanden ist und Sie eine erfolgreiche Nachricht gesendet haben, fügen Sie den Rest Ihrer regulären Modelle hinzu.
Schritt 5: Führen Sie den Cherry Studio-Check aus
Cherry Studio dokumentiert neben dem API-Schlüsselfeld eine Schaltfläche zum Prüfen. Verwenden Sie sie, bevor Sie die Chat-Oberfläche öffnen. Der Check ist nützlich, weil er die häufigsten Cherry Studio API-Probleme erkennt, bevor sie zu verwirrenden Chat-Fehlern werden.
Wenn der Check erfolgreich ist:
- Bestätigen Sie, dass der Anbieter-Schalter eingeschaltet ist.
- Bestätigen Sie, dass das Modell in der Modellliste angezeigt wird.
- Öffnen Sie einen neuen Cherry Studio-Chat.
- Wählen Sie den Flatkey-Anbieter und das von Ihnen gewählte Modell aus.
- Senden Sie einen kleinen Test-Prompt.
- Prüfen Sie das Flatkey-Dashboard auf Nutzungs- und Kostentransparenz.
Wenn der Check fehlschlägt, ändern Sie nicht weiter wahllos Felder. Arbeiten Sie die untenstehende Tabelle zur Fehlerbehebung durch.
Fehlerbehebung bei der Cherry Studio API-Einrichtung
| Problem | Wahrscheinliche Ursache | Behebung |
|---|---|---|
| Prüfung schlägt sofort fehl | Falscher Schlüssel, abgelaufener Schlüssel, kein Kontozugriff oder eingefügtes Leerzeichen. | Kopieren Sie einen neuen Flatkey-Schlüssel aus dem Dashboard und fügen Sie ihn erneut ein. Fügen Sie keine Anführungszeichen oder Leerzeichen ein. |
| Adressfehler oder 404 | Die API Address hat die falsche Pfadstruktur. | Verwenden Sie https://router.flatkey.ai/v1. Wenn Ihr Cherry Studio-Build den gesamten Pfad /v1/chat/completions anhängt, versuchen Sie https://router.flatkey.ai. |
| Modell wird nicht angezeigt | Das Modell wurde nicht zur Modellliste des Anbieters hinzugefügt. | Verwenden Sie in Cherry Studio Manage oder + Add und fügen Sie die exakte Modell-ID von Flatkey hinzu. |
| Prüfung verwendet das falsche Modell | Cherry Studio verwendet beim Prüfen möglicherweise das zuletzt hinzugefügte Chat-Modell. | Entfernen Sie nicht unterstützte Testmodelle und behalten Sie für die erste Prüfung ein bekanntes Chat-Modell bei. |
| Anbieter hat die Prüfung bestanden, fehlt aber im Chat | Der Aktivierungsschalter des Anbieters ist noch ausgeschaltet. | Schalten Sie den Schalter in der Anbieterzeile ein, nachdem die Prüfung erfolgreich war. |
| Nutzung ist später schwer zu erklären | Mehrere Personen teilen sich einen Desktop-Schlüssel. | Erstellen Sie separate Flatkey-Schlüssel pro Benutzer, Gerät oder Umgebung, damit die Nutzungsprotokolle nachvollziehbar bleiben. |
Die meisten Cherry Studio API-Probleme lassen sich auf vier Felder zurückführen: API-Schlüssel, API-Adresse, Modell-ID und Aktivierungsstatus. Prüfen Sie diese, bevor Sie Modelleinstellungen ändern oder zusätzliche Anbieter erstellen.
Wie sich dies von einem direkten OpenAI-Provider-Setup unterscheidet
Ein direktes OpenAI-Provider-Setup verbindet Cherry Studio mit einem Provider-Konto. Ein Flatkey-Cherry Studio API-Setup verbindet Cherry Studio mit einem Gateway, das unterstützte Modelle über einen Schlüssel und ein Dashboard weiterleiten kann.
| Entscheidungsbereich | Direktes Provider-Setup | Flatkey-Setup |
|---|---|---|
| API-Schlüssel | Provider-spezifischer Schlüssel. | Flatkey-Schlüssel für unterstützte Modelle. |
| Base URL | Provider-spezifische API-URL. | https://router.flatkey.ai/v1. |
| Modellerweiterung | Bei Bedarf ein weiteres Provider-Konto oder einen weiteren Schlüssel hinzufügen. | Unterstützte Modell-IDs von Flatkey hinzufügen. |
| Abrechnungsprüfung | Jeden Provider separat prüfen. | Das Dashboard und die Abrechnungsansicht von Flatkey verwenden. |
| Operative Eignung | Gut für einen Provider. | Besser, wenn Cherry Studio ein Desktop-Client für mehrere Modellfamilien ist. |
Wenn Sie bereits Code oder Tools auf ein Gateway-Muster umstellen, lesen Sie nach diesem Setup den Leitfaden zur OpenAI-kompatiblen API-Migration. Wenn Ihr Tool-Stack auch Claude Code oder CC Switch umfasst, behandelt der CC-Switch- und Claude-Code-Flatkey-Leitfaden den angrenzenden Konfigurationspfad für das Tool.
Empfohlene Team-Einrichtung
Für einen individuellen Test reicht ein Flatkey-Schlüssel in Cherry Studio aus. Für ein Team sollten Sie die Cherry Studio API-Einrichtung als Teil Ihrer Richtlinie für den Modellzugriff behandeln.
- Erstellen Sie separate Schlüssel für Entwicklung, produktionsnahe Tests und die private Desktop-Nutzung.
- Benennen Sie Schlüssel nach dem Tool und dem Inhaber, z. B.
cherry-studio-leeodercherry-studio-eval. - Verwenden Sie das Flatkey-Dashboard, um die Nutzung nach dem ersten Test zu überprüfen.
- Richten Sie Kontingentkontrollen ein, bevor Sie weitere Desktop-Nutzer einladen.
- Dokumentieren Sie die freigegebenen Modell-IDs, damit Benutzer keine zufälligen, nicht unterstützten Modelle hinzufügen.
So bleibt der Komfort von Cherry Studio erhalten, ohne die Sicht darauf zu verlieren, wer welches Modell nutzt und wie viel jeder Workflow kostet.
FAQ
Unterstützt Cherry Studio OpenAI-kompatible APIs?
Ja. In der Dokumentation des benutzerdefinierten Providers von Cherry Studio wird OpenAI als unterstützter Providertyp aufgeführt, und die Einstellungen für den Model-Service decken API Key, API Address, Modellverwaltung, Verbindungsprüfungen und den Aktivierungsstatus des Providers ab. Das ist die Konfigurationsoberfläche, die für dieses Cherry Studio API-Setup verwendet wird.
Welche API-Adresse sollte ich für Flatkey in Cherry Studio verwenden?
Verwenden Sie https://router.flatkey.ai/v1 als OpenAI-kompatible Basis-URL von Flatkey. Fügen Sie nicht den vollständigen /chat/completions-Endpunkt in Cherry Studio ein. Wenn Ihre Cherry-Studio-Version eine Root-Adresse erwartet und automatisch /v1/chat/completions anhängt, verwenden Sie https://router.flatkey.ai und führen Sie die Prüfung erneut aus.
Wo bekomme ich den Cherry Studio API-Schlüssel für Flatkey?
Verwenden Sie einen Flatkey-API-Schlüssel aus dem Flatkey-Dashboard. Das Feld für den Cherry Studio API-Schlüssel sollte den Flatkey-Schlüssel enthalten, nicht einen direkten Schlüssel von OpenAI, Anthropic, Google oder einem anderen Anbieter.
Warum erscheint mein Modell nicht in Cherry Studio?
In der Dokumentation von Cherry Studio heißt es, dass abgerufene Modelle dennoch zur Modellliste des Providers hinzugefügt werden müssen. Fügen Sie die exakte Flatkey-Modell-ID über Manage oder + Add hinzu und bestätigen Sie dann, dass der Provider aktiviert ist.
Kann ein einzelner Flatkey-Schlüssel mehrere Cherry-Studio-Modelle verwenden?
Ja, sofern diese Modell-IDs für Ihr Flatkey-Konto verfügbar und in Cherry Studio konfiguriert sind. Für übersichtlichere Protokolle sollten Teams dennoch separate Schlüssel pro Benutzer oder Umgebung in Betracht ziehen.
Soll ich mehrere Flatkey-Schlüssel durch Kommas getrennt hinzufügen?
Cherry Studio dokumentiert das Abrufen mehrerer Provider-Schlüssel durch Kommas getrennt. Beginnen Sie bei Flatkey mit einem Schlüssel, damit Ihre erste Cherry Studio API-Prüfung leichter zu debuggen ist. Fügen Sie mehrere Schlüssel nur hinzu, wenn Ihr Team dafür einen bewussten Grund zur Schlüsselrotation oder Nutzungsaufteilung hat.
Abschließende Prüfung
Ihr Cherry Studio API-Setup über Flatkey ist bereit, wenn diese Prüfungen bestehen:
- Der Anbieter ist eindeutig benannt, zum Beispiel
Flatkey. - Der Anbieter-Typ ist
OpenAI. - Das Feld für den API-Schlüssel enthält einen gültigen Flatkey-Schlüssel.
- Die API-Adresse verweist auf die Flatkey-Router-Basis-URL.
- Mindestens eine gültige Flatkey-Modell-ID wurde hinzugefügt.
- Die Prüfung von Cherry Studio ist erfolgreich.
- Der Anbieter-Schalter ist aktiviert.
- In den Flatkey-Nutzungsprotokollen erscheint ein kleiner Test-Prompt.
Holen Sie sich einen Schlüssel, um Cherry Studio mit Flatkey zu verbinden, und verwenden Sie dann Preise anzeigen, um die Modell-IDs auszuwählen, die Sie in Ihrer Cherry Studio-Modellliste möchten.
