# Benutzerdefiniertes Modell in WorkBuddy einrichten > Eigenes Modell in WorkBuddy in drei Schritten: „Modell hinzufügen“ öffnen, „Benutzerdefiniert“ wählen, OmniaKey API-URL, Schlüssel und Modell-ID eingeben. - Canonical HTML: https://omniakey.com/de/blog/workbuddy-custom-model-setup - Markdown: https://omniakey.com/de/blog/workbuddy-custom-model-setup.md - Published: 2026-08-20 (updated 2026-09-21) - Author: Kiki, COO at OmniaKey - Language: de - Category: API setup - Reading time: 8 min - All posts: https://omniakey.com/blog/llms.txt --- In diesem Handbuch wird die aktuelle benutzerdefinierte Modellschnittstelle von WorkBuddy verwendet. Bereiten Sie einen OmniaKey API-Schlüssel und eine genaue Modell-ID vor, bevor Sie WorkBuddy öffnen. > **Das fertige Formular:** Wählen Sie **Benutzerdefiniert** und verwenden Sie `https://api.omniakey.com/v1`, Ihren OmniaKey API-Schlüssel sowie eine genaue Modell-ID wie `deepseek-v4-flash`. Das Formular, die gespeicherten Modelldetails und die Modellauswahl wurden in der macOS-App überprüft, auf der WorkBuddy `v5.3.14` ausgeführt wird. Die offiziellen Anweisungen von Tencent Cloud erfordern für diese Funktion mindestens `v4.22.15`. |Feld WorkBuddy|Wert| |-|-| |Anbieter|`Custom` unter der Gruppe **Andere**| |Schnittstellenadresse|`https://api.omniakey.com/v1`| |API-Schlüssel|Ein in OmniaKey erstellter Schlüssel| |Modellname|Beispiel: `deepseek-v4-flash`| ## Bevor Sie beginnen, bereiten Sie zwei Dinge vor ### Ein Schlüssel OmniaKey API Melden Sie sich bei OmniaKey an und öffnen Sie die Seite [API-Schlüssel](https://omniakey.com/de/dashboard/tokens): 1. Wählen Sie **Schlüssel erstellen**. 2. Nennen Sie es `WorkBuddy` und legen Sie dann ein geeignetes Limit und einen Ablauf fest. 3. Erstellen Sie es und kopieren Sie sofort den neuen Schlüssel. Lassen Sie den Schlüsseldialog geöffnet, bis Sie die Anmeldeinformationen in WorkBuddy eingefügt haben. Platzieren Sie den Schlüssel nicht in Screenshots, Chat-Nachrichten oder öffentlichen Dateien. Das Konto benötigt außerdem verfügbares Guthaben oder Testguthaben. Durch das Erstellen eines Schlüssels werden lediglich Anmeldeinformationen erstellt. Es garantiert nicht, dass das Konto eine Anfrage finanzieren kann. Derselbe Schlüssel funktioniert auch in anderen Tools; siehe die Anleitungen zu [Cherry Studio API einrichten](https://omniakey.com/de/blog/cherry-studio-api-setup), [eigenem API-Key in Cline](https://omniakey.com/de/blog/cline-custom-api-key) und [Claude Code einrichten](https://omniakey.com/de/blog/claude-code-setup). ### Eine genaue Modell-ID Öffnen Sie den Modellkatalog [OmniaKey](https://omniakey.com/de/models), wählen Sie ein aktuell verfügbares Modell aus und kopieren Sie die auf der Seite angezeigte Modell-ID. Für einen ersten Test verwenden Sie: ```text deepseek-v4-flash ``` Die ID muss exakt übereinstimmen. Geben Sie nicht den Anzeigenamen `DeepSeek V4 Flash` ein, entfernen Sie keine Bindestriche und erfinden Sie keinen kürzeren Alias. ## Schritt 1: Öffnen Sie „Modell hinzufügen“. Starten Sie WorkBuddy und öffnen Sie: ```text System Settings → Models → + Add model ``` Wählen Sie auf der Seite „Modelle“ oben rechts **+ Modell hinzufügen** aus. ![WorkBuddy Seite „Modelleinstellungen“ mit der Schaltfläche „Modell hinzufügen“ in der oberen rechten Ecke](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/01-open-model-settings.2eba6570.1000.webp) _Schritt 1: Systemeinstellungen → Modelle → + Modell hinzufügen._ Sie können auch am Ende einer neuen Aufgabe Folgendes eingeben: ```text Model picker → + Configure custom model ``` Wenn keiner der Einträge verfügbar ist, aktualisieren Sie WorkBuddy auf die Version `v4.22.15` oder höher. Die aktuellen Anleitungen von Tencent Cloud erfordern mindestens diese Version für die Schnittstelle. ## Schritt 2: Wählen Sie „Benutzerdefiniert“ und füllen Sie vier Felder aus Füllen Sie das Formular von oben nach unten aus. ### 1. Wählen Sie den benutzerdefinierten Anbieter Öffnen Sie das Anbietermenü und wählen Sie: ```text Custom ``` In `v5.3.14` erscheint es in der Gruppe **Andere**. Wählen Sie nicht den integrierten OpenAI, Tencent Cloud Token Plan oder einen anderen Anbieter, da diese Profile nicht die Schnittstellenadresse OmniaKey verwenden. ![Benutzerdefinierte Anbieteroption unten im WorkBuddy-Anbietermenü](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/02-choose-custom-provider.fabcb941.560.webp) _Schritt 2: Scrollen Sie zum Ende des Anbietermenüs und wählen Sie unter „Andere“ die Option „Benutzerdefiniert“ aus._ ### 2. Geben Sie die Adresse über `/v1` ein Geben Sie unter **Schnittstellenadresse** oder **Base URL** genau Folgendes ein: ```text https://api.omniakey.com/v1 ``` > **Kopieren Sie nicht den grauen Platzhalter.** Es zeigt ein Beispiel, das auf `/v1/chat/completions` endet, aber OmniaKey verwendet in diesem Feld Base URL `https://api.omniakey.com/v1`. ### 3. Fügen Sie den Schlüssel API ein Fügen Sie den Schlüssel, den Sie von OmniaKey kopiert haben, in **API-Schlüssel** ein. Fügen Sie keine Anführungszeichen, Leerzeichen oder das Wort `Bearer` hinzu. Geben Sie nur den Schlüsselwert ein. ### 4. Geben Sie den Modellnamen ein Geben Sie unter **Modellname** oder **Model ID** die genaue Katalog-ID ein: ```text deepseek-v4-flash ``` Das Kernformular sollte nun lauten: ```text Provider: Custom Interface address: https://api.omniakey.com/v1 API Key: [your OmniaKey API key] Model name: deepseek-v4-flash ``` ![Benutzerdefiniertes Modellformular WorkBuddy, gefüllt mit der Schnittstellenadresse OmniaKey und dem Modellnamen deepseek-v4-flash](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/03-fill-omniakey-fields.addb54d9.560.webp) _Abgeschlossenes Beispiel. Der Schlüssel API ist im Screenshot absichtlich leer; Fügen Sie Ihren eigenen OmniaKey-Schlüssel ein, wenn Sie WorkBuddy konfigurieren._ Lassen Sie für den ersten Verbindungstest die übrigen Felder auf ihren Standardwerten und stellen Sie sicher, dass **Benutzerdefiniertes Protokoll** deaktiviert ist. In `v5.3.14` beginnt ein neues Formular mit aktiviertem Tool calling, deaktivierter Bildeingabe, deaktiviertem Reasoning-Modus, deaktiviertem benutzerdefiniertem Protokoll und standardmäßigen Eingabe- und Ausgabegrenzen des Anbieters. Eine verifizierte `deepseek-v4-flash`-Voreinstellung wird unten angezeigt. ## Schritt 3: Speichern, Modell auswählen und testen Wählen Sie **Speichern** und kehren Sie zu einer neuen Aufgabe zurück. Öffnen Sie unten die Modellauswahl, suchen Sie den Abschnitt „Benutzerdefiniertes Modell“ und wählen Sie `deepseek-v4-flash`. Senden Sie eine kurze Testnachricht: ```text Reply with exactly: Connection successful ``` Eine normale Antwort bestätigt vier Teile des Setups gleichzeitig: 1. WorkBuddy hat den benutzerdefinierten Anbieter gespeichert. 2. Der Base URL ist korrekt. 3. Der Schlüssel API wird akzeptiert und verfügt über ein nutzbares Guthaben. 4. Der Schlüssel kann auf die ausgewählte Modell-ID zugreifen. Öffnen Sie abschließend [OmniaKey Usage](https://omniakey.com/de/dashboard/usage) und bestätigen Sie, dass der Aufruf mit dem erwarteten Modell angezeigt wird. Dadurch wird die Verifizierungsschleife von WorkBuddy bis OmniaKey geschlossen. Wenn das gespeicherte Modell nicht sofort angezeigt wird, schließen Sie die Auswahl und öffnen Sie sie erneut. Beenden Sie WorkBuddy vollständig und starten Sie es neu, wenn es immer noch nicht angezeigt wird. ## Empfohlene erweiterte Einstellungen für den ersten Test Ändern Sie nicht mehrere Funktionskontrollen, bevor der grundlegende Chat funktioniert. Ein neues benutzerdefiniertes Modell in WorkBuddy `v5.3.14` beginnt mit: |Option|Standardeinstellung für neue Form| |-|-| |Tool calling|Auf| |Bildeingabe|Aus| |Argumentationsmodus|Aus| |Benutzerdefiniertes Protokoll|Aus| |Eingabe- und Ausgabegrenzen|Anbietervorgaben| Verwenden Sie diese Standardeinstellungen, um zunächst die URL, den Schlüssel und den Modellnamen zu überprüfen. Passen Sie dann die Funktionen für das Modell an. ### Verifizierte `deepseek-v4-flash`-Voreinstellung Das gespeicherte Modell und erfolgreiche lokale Antworten verwendeten diese Konfiguration: |Option|`deepseek-v4-flash`-Einstellung| |-|-| |Tool calling|Aus| |Bildeingabe|Aus| |Argumentationsmodus|**An**| |Nur Begründung|Aus| |Deaktivierende Argumentation zulassen|**An**| |Benutzerdefiniertes Protokoll|**Aus**| |Standardmäßiger Argumentationsaufwand|`Auto (use request-layer default)`| |Unterstützte Argumentationsbemühungen|Lassen Sie „Niedrig“, „Mittel“, „Hoch“, „Extrahoch“ und „Maximum“ deaktiviert| |Eingabe- und Ausgabegrenzen|Anbietervorgaben| WorkBuddy zeigt nur „Begründung“ an, erlaubt die Deaktivierung der Begründung und die Aufwandskontrolle, nachdem der Begründungsmodus aktiviert wurde. Lassen Sie den Aufwand für den ersten Test auf „Auto“. ### Wann der Tool-Aufruf aktiviert werden soll Aktivieren Sie **Tool calling**, wenn WorkBuddy Dateien lesen, Connectors verwenden oder Agentenaufgaben ausführen muss. Das Modell muss außerdem strukturierte Werkzeugaufrufe unterstützen. `deepseek-v4-flash` verfügt derzeit über Toolunterstützung im OmniaKey-Katalog. Aktivieren Sie diese daher, nachdem der grundlegende Chat funktioniert, und beginnen Sie mit einer schreibgeschützten Aufgabe. Für einen reinen Verbindungstest kann die Funktion ausgeschaltet bleiben. ### Wann soll die Bildeingabe aktiviert werden? Aktivieren Sie es nur für ein Modell, das ausdrücklich als bilderannehmend gekennzeichnet ist. Ein Client-Switch kann einem Nur-Text-Modell keine Vision-Fähigkeit hinzufügen. ### Wann sollte der Argumentationsmodus aktiviert werden? Aktivieren Sie es, wenn in der Katalog- oder Modelldokumentation explizit Argumentation, Denken oder ein ähnlicher Modus aufgeführt ist. Behalten Sie den automatischen Aufwand bei und erlauben Sie deaktivierende Argumentation. Fügen Sie keine nicht unterstützten Aufwandswerte hinzu und machen Sie den reinen Begründungsmodus nicht zum Standard für normale Aufgaben. ## Ein weiteres Modell hinzufügen Überschreiben Sie keinen Arbeitsmodelleintrag. Öffnen Sie **Modell hinzufügen** erneut, behalten Sie die gleiche OmniaKey-URL und den gleichen API-Schlüssel bei, ersetzen Sie nur die genaue Modell-ID und speichern Sie es als weiteres benutzerdefiniertes Modell in WorkBuddy. Überprüfen Sie ein Modell, bevor Sie das nächste hinzufügen. Wenn ein Problem auftritt, wird dadurch deutlich, durch welchen gespeicherten Eintrag es verursacht wurde. ## Fehlerbehebung nach Symptom ### „Benutzerdefiniertes Modell konfigurieren“ fehlt Überprüfen Sie zuerst die WorkBuddy-Version. Aktualisieren Sie auf `v4.22.15` oder höher und schauen Sie dann in der Modellauswahl für neue Aufgaben oder unter **Systemeinstellungen → Modelle** nach. ### HTTP 401, Nicht autorisierter oder ungültiger API-Schlüssel Kopieren Sie den Schlüssel OmniaKey erneut. Suchen Sie nach Leerzeichen und stellen Sie sicher, dass Sie nicht `Bearer` eingefügt haben. Stellen Sie sicher, dass der Schlüssel aktiviert und nicht abgelaufen ist und dass sowohl der Kontostand als auch das Schlüssellimit nutzbar sind. Durch Ändern der Modell-ID wird ein `401` nicht behoben. Die Authentifizierung ist fehlgeschlagen, bevor die Modellauswahl von Bedeutung war. ### HTTP 404 oder Endpunkt nicht gefunden Die Adresse muss genau lauten: ```text https://api.omniakey.com/v1 ``` Verwenden Sie nicht die bloße Domäne, duplizieren Sie `/v1` nicht und hängen Sie `/chat/completions` nicht an. Stellen Sie außerdem sicher, dass **Benutzerdefiniertes Protokoll** deaktiviert ist. ### Modell nicht gefunden oder `UNKNOWN_MODEL` Kopieren Sie die ID erneut aus dem [Live-Modellkatalog](https://omniakey.com/de/models). Ein Anzeigename, ein vermuteter Alias ​​oder eine zurückgezogene ID ist keine gültige aktuelle Modell-ID. ### Der Chat funktioniert, aber die Tools versagen Die Grundmodellanbindung funktioniert bereits. Überprüfen Sie den Tool calling-Schalter von WorkBuddy und die Werkzeugfähigkeit des Modells. Durch die erneute Eingabe des API-Schlüssels oder der URL wird keine Tool-Unterstützung hinzugefügt. ### Die Bildeingabe schlägt fehl Beide Bedingungen müssen erfüllt sein: Das Modell unterstützt Bilder und die Bildeingabesteuerung von WorkBuddy ist aktiviert. ### Das Modell fehlt nach dem Speichern Bestätigen Sie, dass Sie **Speichern** ausgewählt haben, und öffnen Sie dann die Modellauswahl erneut. Starten Sie WorkBuddy bei Bedarf neu. Wenn der Konfigurationseintrag selbst nicht verfügbar ist, überprüfen Sie die Client-Version erneut. ## Häufig gestellte Fragen ### Welche OmniaKey-URL sollte WorkBuddy verwenden? Verwenden Sie nur `https://api.omniakey.com/v1`. Es ist ein Base URL; WorkBuddy hängt den Operationspfad an. ### Benötige ich eine `models.json`-Datei? Nein. Dieses Handbuch basiert auf der aktuellen Benutzeroberfläche **Benutzerdefiniertes Modell konfigurieren**. Ältere Anweisungen zur lokalen Konfigurationsdatei beschreiben einen anderen Setup-Pfad. ### Kann ich GPT, Claude, Gemini oder ein anderes Modell konfigurieren? Ja, wenn das Modell derzeit in OmniaKey aufgeführt ist und die OpenAI-kompatible Route unterstützt. Behalten Sie die gleiche URL bei und verwenden Sie die exakte Katalogmodell-ID. ### Ist MCP in diesem Formular konfiguriert? Nein. Dieses Formular konfiguriert das Modell API. MCP und Anschlüsse sind separate WorkBuddy-Einstellungen. Erstellen Sie eine grundlegende Modellreaktion, bevor Sie diese Tools hinzufügen. ## Geprüfte Referenzen - [Tencent Cloud: WorkBuddy konfigurieren und verwenden](https://cloud.tencent.com/document/product/1823/130064) - [OmniaKey OpenAI-kompatible API-Referenz](https://docs.omniakey.com/en/api/openai-compatible) - [OmniaKey Live-Modellkatalog](https://omniakey.com/de/models)