GPT und Drittanbieter-APIs in Cherry Studio einrichten
Wählen Sie das richtige Protokoll, geben Sie die Stamm-URL des Anbieters ein, fügen Sie die genaue Modell-ID hinzu und überprüfen Sie eine kleine Anfrage, bevor Sie das Setup erweitern.
Die Suche nach wie man GPT mit Cherry Studio verbindet bedeutet normalerweise, dass Sie eine funktionierende Anbieterkonfiguration benötigen, keine Funktionseinführung. Die wichtigen Felder sind das Protokoll, der Schlüssel API, die Basis-URL und die genaue Modell-ID.
Der kurze Weg ist:
Einstellungen → Modelldienst → Anbieter auswählen oder hinzufügen → Anmeldeinformationen und API-URL eingeben → Modell abrufen oder hinzufügen → Anbieter aktivieren → Gesundheitsprüfung durchführen.
Cherry Studio verfügt über integrierte Anbieter für Dienste wie OpenAI, Anthropic, Google Gemini, DeepSeek, Moonshot, Ollama und LM Studio. Ein Gateway oder ein selbstgehosteter Dienst kann über einen benutzerdefinierten Anbieter hinzugefügt werden, wenn er einen OpenAI-kompatiblen, Anthropic- oder Gemini-Endpunkt verfügbar macht. Die aktuellen UI-Namen finden Sie im offiziellen Leitfaden zu Anbietereinstellungen.
Was Sie vor dem Öffnen von Cherry Studio benötigen
Bereiten Sie vier Werte aus dem Dienst vor, den Sie verwenden möchten:
| Wert | Was es bedeutet |
|---|---|
| Protokoll | OpenAI-kompatibel, Anthropic-Nachrichten, Gemini oder das dokumentierte Format des Anbieters |
| API-Schlüssel | Die Anmeldeinformationen, die zur Authentifizierung der Anfrage verwendet werden |
| Base URL | Die Root-Adresse API, es sei denn, der Anbieter verlangt ausdrücklich einen vollständigen Endpunkt |
| Model ID | Die genaue Zeichenfolge, die vom Upstream API akzeptiert wird |
Verwenden Sie kein Web-Chat-Passwort als API-Schlüssel. Ein ChatGPT-Abonnement, ein API-Konto und ein Drittanbieter-Gateway sind separate Zugriffspfade. Verwenden Sie die Anmeldeinformationen und den Endpunkt, die vom ausgewählten Dienst dokumentiert sind.
Verbinden Sie GPT in fünf Schritten
1. Offener Modelldienst
Starten Sie Cherry Studio und öffnen Sie Einstellungen → Modelldienst. Wählen Sie den integrierten Anbieter OpenAI, wenn Sie OpenAI direkt anrufen. Wählen Sie für ein Gateway, einen Aggregator oder eine private Bereitstellung Anbieter hinzufügen und erstellen Sie einen separaten benutzerdefinierten Eintrag.
Der Anbieter wird anhand seines Protokolls ausgewählt, nicht anhand des Worts GPT im Modellnamen. Ein GPT-gekennzeichnetes Modell hinter einem Anthropic-kompatiblen Gateway benötigt weiterhin das Protokollprofil Anthropic.
2. Füllen Sie die Anbieterfelder aus
Verwenden Sie für jedes Feld die Dokumentation des Anbieters:
| Feld Cherry Studio | Was Sie eingeben müssen | Vermeiden |
|---|---|---|
| Anbietername | Ein Etikett, das Sie später wiedererkennen werden | Wiederverwendung einer Bezeichnung für nicht verwandte Endpunkte |
| API-Schlüssel | Nur der Schlüsselwert | Zusätzliche Leerzeichen, Anführungszeichen oder Bearer |
| Typ API | Das Protokoll, das der Endpunkt tatsächlich implementiert | Vermutung anhand des Marketingnamens des Modells |
| API-Adresse | Die dokumentierte Stamm-URL oder die erforderliche vollständige URL | Eine Dashboard-URL oder ein duplizierter Pfad |
Bei einem üblichen OpenAI-kompatiblen Dienst ergänzt Cherry Studio die Root-Adresse um Version und Request-Pfad. Nennt der Anbieter https://api.example.com und https://api.example.com/v1/chat/completions, ist der erste Wert normalerweise die Base URL. Fügen Sie /v1 nicht doppelt hinzu und verwenden Sie den vollständigen Pfad nur auf ausdrückliche Anweisung.
Der Leitfaden für benutzerdefinierte Anbieter behandelt zusätzliche Endpunkte, manuelle Modelleingabe und lokale Dienste im vLLM-Stil.
3. Modell abrufen oder hinzufügen
Klicken Sie auf Modellliste abrufen. Wenn der Endpunkt die Modellerkennung verfügbar macht, fügen Sie das Modell mit der Schaltfläche + hinzu. Die zurückgegebene ID ist maßgeblich: Datumsangaben, Herstellerpräfixe, Bindestriche und Versionssuffixe müssen genau wie angezeigt beibehalten werden.
Wenn der Anbieter keine Modellliste bereitstellt, fügen Sie das Modell manuell hinzu. Durch eine erfolgreiche Anbieterspeicherung wird ein Modell nicht automatisch in der Chat-Auswahl verfügbar gemacht. Das Modell muss hinzugefügt und der Anbieterwechsel aktiviert werden.
4. Überprüfen Sie eine kurze Anfrage
Verwenden Sie Überprüfen mit dem Modell, das Sie gerade hinzugefügt haben, und senden Sie dann eine minimale Eingabeaufforderung:
Reply with exactly: connection successful
Dadurch werden Authentifizierungs- und Routingprobleme von Vision-, Tools-, Long-Context- oder Agentenfähigkeitsproblemen getrennt. Bestätigen Sie den Aufruf auf der Nutzungsseite des Anbieters, sofern eine solche verfügbar ist.
5. Fügen Sie nacheinander erweiterte Funktionen hinzu
Nachdem der reine Text funktioniert, testen Sie nacheinander Streaming, Bilder, Tools oder Argumentationsparameter. Eine erfolgreiche Chat-Antwort beweist nur, dass die grundlegende Textroute funktioniert; Es beweist nicht, dass das Modell oder Protokoll alle von Cherry Studio bereitgestellten Funktionen unterstützt.
Anbindung anderer APIs von Drittanbietern
OpenAI-kompatible Gateways
Verwenden Sie Benutzerdefinierter Anbieter → OpenAI, wenn das Gateway OpenAI Chat Completions oder eine andere OpenAI-kompatible Oberfläche dokumentiert. Dies ist der übliche Weg für Aggregatoren, private Gateways, vLLM und viele gehostete offene Modelle.
Multiprotokoll-Gateways
Gateways im NewAPI-Stil können OpenAI-Chat, OpenAI-Antworten, Anthropic-Nachrichten und Gemini-Routen von einer Root-Adresse aus verfügbar machen. Die NewAPI-Anweisungen von Cherry Studio erklären, dass der Client den Versionspfad für das ausgewählte Protokoll auswählt. Verwenden Sie die NewAPI-Voreinstellung, wenn das Gateway diesem Vertrag folgt. Verwenden Sie einen benutzerdefinierten Anbieter, wenn dieser über einen dokumentierten Pfad oder eine Modellerkennungsvariante verfügt.
Ollama, LM Studio und vLLM
Wählen Sie den passenden lokalen Anbieter aus oder verwenden Sie einen benutzerdefinierten OpenAI-Anbieter, wenn der lokale Server einen OpenAI-kompatiblen API bereitstellt. Geben Sie den Modellnamen ein, den der lokale Server tatsächlich geladen hat. Die lokale Ausführung kann die Datenexposition verringern, lokale Modelle unterscheiden sich jedoch immer noch in Bezug auf Vision, Tools, Kontextlänge und Argumentationsunterstützung.
Wenn die Modellliste leer ist
Gehen Sie diese Prüfungen der Reihe nach durch:
- Bestätigen Sie, dass der Dienst einen Modelllistenendpunkt implementiert. Einige APIs akzeptieren nur eine manuell bereitgestellte Modell-ID.
- Entfernen Sie doppelte Pfadsegmente. Eine Root-URL, die bereits
/v1enthält, kann fehlschlagen, wenn Cherry Studio eine weitere/v1anhängt. - Überprüfen Sie, ob Sie die API-Adresse und nicht die Management-Dashboard-Adresse des Anbieters verwendet haben.
- Kopieren Sie die genaue Modell-ID, die vom Anbieter zurückgegeben wurde. Anzeigenamen und API-IDs sind nicht austauschbar.
- Stellen Sie sicher, dass der Anbieter aktiviert ist. Ein deaktivierter Anbieter verbirgt seine Modelle vor der Auswahl.
Häufige Fehler
| Fehler | Wahrscheinliche Ursache | Erster Check |
|---|---|---|
401 Unauthorized | Ungültiger, abgelaufener oder falsch formatierter Schlüssel | Kopieren Sie den Schlüssel erneut und bestätigen Sie das Protokollprofil |
403 Forbidden | Konto, Projekt, Saldo oder Schlüssellimit | Überprüfen Sie die Berechtigungen und Kontingente des Anbieters |
404 Not Found | Falsche Root-URL, doppelter Versionspfad oder Protokollkonflikt | Stellen Sie die dokumentierte Basis-URL wieder her |
400 Bad Request | Nicht unterstützter Parameter oder Anforderungsform | Entfernen Sie benutzerdefinierte Parameter und versuchen Sie es erneut mit Nur-Text |
model not found | Falsche ID oder Modell nicht in Cherry Studio hinzugefügt | Kopieren Sie die genaue Upstream-Modell-ID |
| Text funktioniert, aber Bilder/Tools schlagen fehl | Dem Modell oder Protokoll fehlt diese Fähigkeit | Überprüfen Sie die Fähigkeitsliste und die Route |
| Auszeit | Anbieterlatenz, Netzwerkproblem oder übergroße Anfrage | Versuchen Sie es erneut mit einer kurzen Eingabeaufforderung und einem Modell |
Ändern Sie jeweils eine Variable. Beginnen Sie mit einem Anbieter, einem Modell und einer kurzen Anfrage; Fügen Sie erst dann mehrere Modelle oder Werkzeuge hinzu.
Vergleich mehrerer Modelle
Mit Cherry Studio können Sie in der Konversationsauswahl zwischen Modellen wechseln und dieselbe Aufforderung an mehrere ausgewählte Modelle senden. Jede Auswahl erzeugt eine unabhängige Anfrage. Es ist zum Vergleich nützlich, stellt jedoch keine automatische Bewertung oder Qualitätsgarantie dar; Die Anzahl der Anfragen, die Kosten und die Datenexposition steigen mit jedem ausgewählten Modell. Der offizielle Vergleichsleitfaden empfiehlt, explizite Bewertungskriterien zu formulieren, anstatt einfach zu fragen, welche Antwort „am besten“ ist.
Verwenden Sie OmniaKey als einen Anbieter
Wenn Sie keine separaten Einstiegspunkte für GPT, Claude, Gemini und andere Modelle verwalten möchten, konfigurieren Sie OmniaKey als benutzerdefinierten OpenAI-kompatiblen Anbieter in Cherry Studio.
- Erstellen Sie einen dedizierten OmniaKey API-Schlüssel und legen Sie auf der Seite API-Schlüssel ein geeignetes Schlüssellimit fest.
- Öffnen Sie Einstellungen → Modelldienst → Anbieter hinzufügen in Cherry Studio.
- Wählen Sie den OpenAI-kompatiblen Typ und geben Sie die Basis-URL und den Schlüssel aus der OmniaKey-Schnellstartanleitung ein.
- Rufen Sie die Modellliste ab oder fügen Sie eine genaue ID aus dem Live-Modellkatalog hinzu.
- Aktivieren Sie den Anbieter, führen Sie eine kurze Prüfung durch und bestätigen Sie die Anfrage in Nutzung.
Der aktuelle OmniaKey-Katalog umfasst Claude, GPT, Gemini und Grok sowie weitere Modellfamilien. IDs und Funktionen sind dynamisch. Verwenden Sie daher den Live-Katalog und nicht ein altes Tutorial. Eine OpenAI-kompatible Route macht nicht alle anbieterspezifischen Funktionen identisch; Überprüfen Sie die Modell- und Protokollfähigkeit, bevor Sie Vision oder Tools aktivieren.
FAQ
Kann Cherry Studio jedes API verwenden, das ich finde?
Nur wenn der Dienst ein Protokoll bereitstellt, das Cherry Studio unterstützt. Eine beliebige URL ohne dokumentiertes Anforderungsformat, Authentifizierungsmethode und Modell-ID reicht nicht aus.
Soll ich eine Root-URL oder /chat/completions eingeben?
Befolgen Sie die Dokumentation des Anbieters. Herkömmliche Anbieter verwenden normalerweise die Root-URL und lassen Cherry Studio den Anforderungspfad anhängen; Verwenden Sie einen vollständigen Endpunkt nur, wenn der Anbieter dies ausdrücklich erfordert.
Warum kann ich chatten, aber keine Tools oder Bilder verwenden?
Grundlegender Texterfolg beweist nicht, dass das ausgewählte Modell, Protokoll und die Client-Route Tools oder Visionen unterstützen. Überprüfen Sie jede Fähigkeit separat.
Ist ein ChatGPT-Webabonnement ein API-Schlüssel?
Nein. Cherry Studio benötigt einen Provider-Zugangsdatensatz API oder einen kompatiblen Gateway-Zugangsdatensatz. Web-Anmeldedaten sollten niemals in das Schlüsselfeld API eingefügt werden.
Quellen und Frische
In diesem Handbuch werden die aktuelle Provider-, Custom-Provider-, OpenAI-, NewAPI- und Multi-Modell-Dokumentation von Cherry Studio sowie die aktuelle API- und Modell-Dokumentation von OmniaKey verwendet. Technische Werte wie Modell-IDs, Anbieterfunktionen und Routen können sich ändern; Überprüfen Sie diese zum Zeitpunkt der Konfiguration.