Benutzerdefiniertes Modell in WorkBuddy einrichten
Geben Sie die URL, den API-Schlüssel und den Modellnamen in der angezeigten Reihenfolge ein und überprüfen Sie dann die vollständige Verbindung.
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:
- Wählen Sie Schlüssel erstellen.
- Nennen Sie es
WorkBuddyund legen Sie dann ein geeignetes Limit und einen Ablauf fest. - 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.
Eine genaue Modell-ID
Öffnen Sie den Modellkatalog OmniaKey, 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:
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:
System Settings → Models → + Add model
Wählen Sie auf der Seite „Modelle“ oben rechts + Modell hinzufügen aus.
Sie können auch am Ende einer neuen Aufgabe Folgendes eingeben:
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:
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.
2. Geben Sie die Adresse über /v1 ein
Geben Sie unter Schnittstellenadresse oder Base URL genau Folgendes ein:
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:
deepseek-v4-flash
Das Kernformular sollte nun lauten:
Provider: Custom
Interface address: https://api.omniakey.com/v1
API Key: [your OmniaKey API key]
Model name: deepseek-v4-flash
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:
Reply with exactly: Connection successful
Eine normale Antwort bestätigt vier Teile des Setups gleichzeitig:
- WorkBuddy hat den benutzerdefinierten Anbieter gespeichert.
- Der Base URL ist korrekt.
- Der Schlüssel API wird akzeptiert und verfügt über ein nutzbares Guthaben.
- Der Schlüssel kann auf die ausgewählte Modell-ID zugreifen.
Öffnen Sie abschließend OmniaKey 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.
Ü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:
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. 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.