Cherry Studio Konfiguration

Cherry Studio ist ein plattformübergreifender AI Desktop-Client (unterstützt Windows, macOS, Linux) mit Multi-Modell-Konversationen, Wissensdatenbank und Workflow-Unterstützung — einer der funktionsreichsten Open-Source AI-Clients.

Durch die Konfiguration von OfoxAI als Anbieter können Sie GPT, Claude, Gemini, DeepSeek und 100+ weitere Modelle in Cherry Studio mit nur einem API Key nutzen.

Protokollübersicht

Cherry Studio unterstützt die Verbindung zu OfoxAI über vier Protokolle:

OpenAI Chat — Basierend auf /v1/chat/completions, für GPT-Modelle wie openai/gpt-4.1, openai/gpt-5.5.

OpenAI Response — Basierend auf /v1/responses, für GPT-Modelle wie openai/gpt-4.1, openai/gpt-5.4-mini.

Claude — Basierend auf /anthropic/v1/messages, für Claude-Modelle wie anthropic/claude-sonnet-4.6, anthropic/claude-opus-4.6.

Gemini — Basierend auf /gemini/v1beta/models, für Gemini-Modelle wie google/gemini-3.1-pro-preview, google/gemini-3.1-flash-lite.

Voraussetzungen

Ein OfoxAI-Konto mit API Key (Hier erhalten )
Cherry Studio installiert (Download )

Konfigurationsschritte

Schritt 1: Einstellungen öffnen

Starten Sie Cherry Studio und klicken Sie auf das Einstellungen-Symbol oben rechts.

Cherry Studio Einstellungen öffnen

Schritt 2: Modellanbieter hinzufügen

Gehen Sie zu Modelldienste in der linken Seitenleiste, scrollen Sie nach unten und klicken Sie auf + Hinzufügen. Geben Sie im Dialog einen Anbieternamen ein und wählen Sie den entsprechenden Anbietertyp.

OpenAI Chat

Wählen Sie OpenAI als Anbietertyp und klicken Sie auf OK.

OpenAI Chat Anbieter hinzufügen

OpenAI Response

Wählen Sie OpenAI als Anbietertyp (Response-Modus wird später auf der Konfigurationsseite aktiviert) und klicken Sie auf OK.

OpenAI Response Anbieter hinzufügen

Claude

Wählen Sie Anthropic als Anbietertyp und klicken Sie auf OK.

Claude Anbieter hinzufügen

Gemini

Wählen Sie Gemini als Anbietertyp und klicken Sie auf OK.

Gemini Anbieter hinzufügen

Schritt 3: API-Konfiguration eingeben

Geben Sie den API-Schlüssel und die API-Adresse auf der Konfigurationsseite des Anbieters ein.

OpenAI Chat

Feld	Wert
API-Schlüssel	Ihr OfoxAI API Key
API-Adresse	`https://api.ofox.io/v1`

OpenAI Chat Konfiguration

OpenAI Response

Feld	Wert
API-Schlüssel	Ihr OfoxAI API Key
API-Adresse	`https://api.ofox.io/v1`

OpenAI Response Konfiguration

Claude

Feld	Wert
API-Schlüssel	Ihr OfoxAI API Key
API-Adresse	`https://api.ofox.io/anthropic`

Claude Konfiguration

Gemini

Feld	Wert
API-Schlüssel	Ihr OfoxAI API Key
API-Adresse	`https://api.ofox.io/gemini`

Gemini Konfiguration

Stellen Sie sicher, dass der Schalter oben rechts auf der Seite eingeschaltet (ON) ist, sonst erscheint der Anbieter nicht im Modellselektor.

Schritt 4: Modelle hinzufügen

Klicken Sie auf die Schaltfläche Verwalten im Modellbereich, um die Modellliste automatisch abzurufen, und klicken Sie auf + neben einem Modell, um es zur aktivierten Liste hinzuzufügen.

OpenAI Chat

OpenAI Chat Modellliste

OpenAI Response

OpenAI Response Modellliste

Claude

Claude Modellliste

Gemini

Gemini Modellliste

Schritt 5: Konfiguration überprüfen

Klicken Sie auf die Schaltfläche Testen, wählen Sie ein beliebiges Modell zum Testen. Ein bestandener Test bedeutet, dass die Konfiguration erfolgreich ist.

OpenAI Chat

OpenAI Chat Überprüfung

OpenAI Response

OpenAI Response Überprüfung

Claude

Claude Überprüfung

Gemini

Gemini Überprüfung

Nutzung starten

Kehren Sie zur Hauptoberfläche zurück, klicken Sie auf den Modellselektor oben im Chat und wählen Sie ein Modell unter der entsprechenden Anbietergruppe, um zu chatten.

Modell auswählen und chatten

Bildgenerierung

Cherry Studio unterstützt die Bildgenerierung über das Gemini-Protokoll mit den Bildgenerierungsmodellen von OfoxAI direkt in Konversationen.

Schritt 1: Gemini-Anbieter hinzufügen

Gehen Sie zu Modelldienste und klicken Sie unten auf + Hinzufügen.

Anbieter hinzufügen

Wählen Sie im Dialog Gemini als Anbietertyp und klicken Sie auf OK.

Gemini-Typ auswählen

Schritt 2: Konfigurieren und Bildmodelle abrufen

Geben Sie als API-Adresse https://api.ofox.io/gemini ein, klicken Sie auf Modellliste abrufen und fügen Sie folgende Bildgenerierungsmodelle hinzu:

Google: Nano Banana Pro (Gemini 3 Pro Image Preview)
Google: Nano Banana (Gemini 2.5 Flash Image)
Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview)

Bildmodelle abrufen

Schritt 3: Assistent bearbeiten und Bildparameter konfigurieren

Klicken Sie mit der rechten Maustaste auf einen Assistenten und wählen Sie Assistent bearbeiten.

Assistent bearbeiten

Auf der Bearbeitungsseite:

Setzen Sie das Standardmodell auf das gerade hinzugefügte Bildgenerierungsmodell
Klicken Sie auf + Parameter hinzufügen und fügen Sie folgende zwei benutzerdefinierte Parameter hinzu:

Parameter	Typ	Wert
`responseModalities`	JSON	`["IMAGE"]`
`imageConfig`	JSON	`{"aspectRatio": "1:1", "imageSize": "1K"}`

In imageConfig können Sie das Seitenverhältnis und die Auflösung anpassen. Für 2K-Bilder ändern Sie imageSize auf "2K".

Bildparameter konfigurieren

Schritt 4: Bilder generieren

Nach dem Speichern der Konfiguration geben Sie eine Bildbeschreibung im Chat ein, um Bilder zu generieren.

Bildgenerierungsergebnis

Neues Cherry Studio: ein Anbieter, mehrere Protokolle

Die neueste Cherry-Studio-Version erlaubt es, innerhalb eines Anbieters für jedes Protokoll eine eigene Anfrageadresse festzulegen. Fügen Sie einen einzigen OfoxAI-Anbieter hinzu, um GPT-, Claude- und Gemini-Modelle gemeinsam zu nutzen – inklusive Bildgenerierung und Bildbearbeitung.

Schritt 1: Anfragekonfiguration ausfüllen

Öffnen Sie nach der Eingabe des API-Schlüssels auf der Anbieterseite die Anfragekonfiguration, tragen Sie die Adresse jedes Protokolls gemäß der Tabelle ein und klicken Sie auf Speichern:

Protokoll / Feld	Adresse
OpenAI (Standard)	`https://api.ofox.io/v1`
Anthropic	`https://api.ofox.io/anthropic`
Gemini	`https://api.ofox.io/gemini`
OpenAI Responses	`https://api.ofox.io/v1`
Basis-URL für Bildgenerierung	`https://api.ofox.io/v1`
Bildbearbeitungs-Grund-URL	`https://api.ofox.io/v1`

Anfragekonfiguration: Adressen für OpenAI, Anthropic, Gemini und OpenAI Responses

Anfragekonfiguration: Basis-URLs für Bildgenerierung und Bildbearbeitung

Als Standard festlegen bestimmt, welches Protokoll normale Chats standardmäßig verwenden. Die Basis-URL für Bildgenerierung entspricht /images/generations, die Bildbearbeitungs-Grund-URL entspricht /images/edits; bleiben sie leer, wird die Base URL des Standard-Chat-Endpunkts verwendet. Die Screenshots nutzen den Mirror api.ofox.io, der auch aus Festlandchina erreichbar ist; in anderen Netzwerken verwenden Sie api.ofox.io.

Schritt 2: Mit mehreren Modellen chatten

Nach dem Hinzufügen der Modelle können Sie unter demselben Anbieter zwischen Modellen von Gemini, GPT, Claude und weiteren Herstellern wechseln. Der Screenshot zeigt nacheinander Gemini 3.8 Flash, GPT-6 Luna und Claude Sonnet 5.5:

Chat mit Gemini-, GPT- und Claude-Modellen unter einem Anbieter

Schritt 3: Bilder generieren und bearbeiten

Fügen Sie ein Bildmodell hinzu (z. B. openai/gpt-image-2), wählen Sie es auf der Zeichenseite aus und geben Sie eine Beschreibung ein, um ein Bild zu erzeugen:

Bild mit GPT-Image-2 generieren

Laden Sie ein Referenzbild hoch und geben Sie eine Bearbeitungsanweisung ein (z. B. „mach daraus einen Hund“), um das Original zu bearbeiten:

Bild mit GPT-Image-2 bearbeiten

Häufige Fragen

Q: Die Modellliste ist nach dem Klicken auf „Verwalten” leer

Überprüfen Sie, ob die API-Adresse korrekt ist (kein Schrägstrich am Ende) und ob der API-Schlüssel vollständig kopiert wurde, ohne zusätzliche Leerzeichen.

Q: Verbindungsfehler bei der Überprüfung

Bestätigen Sie, dass der API Key vollständig aus der OfoxAI-Konsole kopiert wurde, ohne zusätzliche Leerzeichen
Bestätigen Sie, dass die API-Adresse korrekt ist
Bestätigen Sie, dass Ihre Netzwerkverbindung funktioniert

Q: Der Anbieter erscheint nicht im Modellselektor

Überprüfen Sie, ob der Schalter oben rechts auf der Konfigurationsseite aktiviert ist.