OneAster in Cherry Studio verwenden

​

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher:

1. Cherry Studio ist installiert
   Laden Sie die für Ihr Betriebssystem passende Version von der offiziellen Cherry-Studio-Website herunter und installieren Sie sie
2. oneaster-API-Schlüssel vorhanden
   Melden Sie sich in der oneaster-Konsole an, um Ihren API-Schlüssel zu erhalten (beginnt mit sk-)

​

Schritt 1: Cherry-Studio-Einstellungen öffnen

Nach dem Start von Cherry Studio navigieren Sie zur Einstellungsseite:

1. Klicken Sie auf das ⚙️ Einstellungen-Symbol (Zahnrad) oben rechts
2. Oder verwenden Sie Tastenkürzel:
   • Windows/Linux: Ctrl + ,
   • macOS: Cmd + ,

​

Schritt 2: oneaster-Modellplattform hinzufügen

​

2.1 Modellservice-Verwaltung aufrufen

Auf der Einstellungsseite:

1. Suchen Sie im linken Menü die Option Modellservice
2. Klicken Sie darauf, um die Modellservice-Verwaltung zu öffnen

​

2.2 oneaster-Anbieter hinzufügen

1. Unten auf der Modellservice-Seite klicken Sie auf die Schaltfläche „+ Hinzufügen”

2. Füllen Sie im Dialog „Anbieter hinzufügen” aus:
   • Anbietername: oneaster (anpassbar)
   • Anbietertyp: Wählen Sie OpenAI
3. Klicken Sie auf „Bestätigen”

​

2.3 oneaster-API-Informationen konfigurieren

Nach dem Hinzufügen des Anbieters füllen Sie die API-Informationen im rechten Konfigurationsbereich aus:

​

Schritt 3: Modelle hinzufügen und verwalten

​

3.1 Modellverwaltung öffnen

Nach der Konfiguration des oneaster-Anbieters:

1. Stellen Sie sicher, dass der Schalter des oneaster-Anbieters oben rechts AN (grün) ist
2. Suchen Sie im rechten Konfigurationsbereich den Abschnitt „Modelle”
3. Klicken Sie auf „Verwalten”, um das Modellauswahlfenster zu öffnen

​

3.2 Gewünschte Modelle hinzufügen

Im Modellauswahlfenster:

1. Verwenden Sie das Suchfeld, um bestimmte Modelle zu finden
2. Filtern Sie über die Kategorie-Tabs oben: Alle, Reasoning, Vision, Web, Free, Embedding, Rerank, Tool
3. Suchen Sie die gewünschten Modelle und klicken Sie rechts auf +, um sie hinzuzufügen:
   • gpt-4o / chatgpt-4o – OpenAI GPT-4o-Modell
   • gpt-4o-mini – Schnellere und sparsamere Version
   • claude-3-Serie – Claude-3-Modelle (mit mehreren Varianten)
   • claude_code_sonnet-4 – Claude Code Sonnet 4
   • claude_code_haiku-4 – Claude Code Haiku 4
   • gemini-2.0-flash-exp – Google Gemini 2.0 Flash

4. Schließen Sie nach dem Hinzufügen aller gewünschten Modelle das Modellauswahlfenster

​

Schritt 4: Chat starten

Nach der Konfiguration können Sie loslegen:

1. Kehren Sie zur Hauptoberfläche zurück, klicken Sie oben auf „+” oder wählen Sie einen bestehenden Chat
2. Klicken Sie oben im Chat auf die Modellauswahl
3. Wählen Sie ein Modell unter dem Anbieter OneAster
4. Beginnen Sie, mit der KI zu chatten!

​

FAQ

​

Q1: Keine Verbindung zum oneaster-Dienst möglich?

Lösung:

1. Base URL prüfen:
   • Stellen Sie sicher, dass die Base URL https://api.oneaster.ai ist
   • Fügen Sie kein /v1-Suffix hinzu
2. API Key überprüfen:
   • Bestätigen Sie, dass der API Key korrekt ist und mit sk- beginnt
   • Prüfen Sie die Gültigkeit in der oneaster-Konsole
3. Netzwerkverbindung prüfen:
   • Stellen Sie sicher, dass Sie auf https://api.oneaster.ai zugreifen können
   • In China kann eine Proxy-Konfiguration erforderlich sein

​

Q2: Modellliste ist leer oder lässt sich nicht aktualisieren?

Lösung:

1. Modelle manuell hinzufügen:
   • Wenn die automatische Aktualisierung fehlschlägt, können Sie gängige Modelle manuell hinzufügen
   • Geben Sie in der Modellverwaltung die Modellnamen manuell ein (z. B. gpt-4o)
2. API-Berechtigungen prüfen:
   • Bestätigen Sie, dass Ihr API Key Zugriff auf die Modellliste hat
   • Kontaktieren Sie den oneaster-Support, um den Kontostatus zu prüfen

​

Q3: Fehlermeldungen während des Gesprächs?

Häufige Fehler und Lösungen:

​

Q4: Wie sehe ich API-Nutzung und Kosten ein?

Melden Sie sich in der oneaster-Konsole an, um Folgendes zu sehen:

• 📊 API-Aufruf-Statistik
• 💰 Kostendetails
• 📈 Nutzungstrend-Diagramme

​

Funktionen

Mit Cherry Studio + OneAster können Sie:

• 💬 Multi-Modell-Konversationen – Verschiedene KI-Modelle in derselben Oberfläche nutzen
• 🖼️ Bildverständnis – Multimodale Konversationen mit Unterstützung für Bildeingaben
• 📝 Kontextverwaltung – Intelligente Verwaltung des Konversationsverlaufs und Kontexts
• 🎨 Benutzerdefinierte Prompts – Prompt-Vorlagen erstellen und verwalten
• 📊 Konversationen exportieren – Konversationsverläufe in Markdown und andere Formate exportieren
• 🔄 Modellvergleich – Mehrere Modelle gleichzeitig verwenden und Ausgaben vergleichen

​

Support & Hilfe

Wenn Sie auf Probleme stoßen:

• 📚 oneaster-Dokumentation
• 💬 Discord-Community
• 🐦 Twitter @oneaster_
• 📧 Technischer Support: [email protected]

---