Clients/WorkBuddy
Wokey API mit WorkBuddy nutzen
Hol dir einen Wokey-API-Key, trag in WorkBuddy die Base URL von Wokey ein und prüf die Verbindung mit einer curl-Anfrage.
Aktualisiert
Auf dieser Seiteexpand_more
API-Key und Base URL bereitlegenlink
Alle Clients nutzen denselben Wokey-API-Key und dieselbe Base URL.
API-Key erstellen
Melde dich an und erstelle auf der API-Seite einen Plattform-Key. Alle Keys eines Kontos teilen sich dessen Guthaben.
API-Key erstellenkeyBase URL von Wokey verwenden
Trag als Base URL des Clients die Gateway-Domain ein; die Konfiguration unten zeigt, ob /v1 angehängt wird.
Client einrichtenlink
WorkBuddy nutzt für eigene Modelle OpenAI Chat Completions. Öffne in WorkBuddy Settings → Model → Custom models und trag den Endpunkt von Wokey, den API-Key und deepseek-v4.1-flash ein; Tool-Aufrufe und Bildeingabe stehen dann in WorkBuddy-Aufgaben und Agent-Workflows zur Verfügung.
- 1
Modelleinstellungen öffnen
Klick unten links in WorkBuddy auf die Konto-Schaltfläche → Settings → Model. Alternativ öffnest du die Modellauswahl und wählst Configure custom model.
- 2
Eigenes Modell hinzufügen
Wähl Custom. Setz den Endpunkt auf https://api.wokey.ai, füg deinen Wokey-API-Key ein und trag die exakte Modell-ID deepseek-v4.1-flash ein (die alte ID deepseek-flash funktioniert ebenfalls).
- 3
Fähigkeiten einstellen
Aktiviere Tool-Aufrufe und Bildeingabe. Lass den Reasoning-Modus und das eigene Protokoll aus. deepseek-v4.1-flash akzeptiert Text, Bilder und Tools; nutzt du stattdessen deepseek-v4-flash, schalte die Bildeingabe aus, denn dieses Modell verarbeitet nur Text.
- 4
Speichern und Modell wechseln
Führ Test connection aus, speichere das Modell und wähl es dann in der Modellauswahl der Unterhaltung. Beginne mit einem kurzen Text-Prompt, bevor du Tools oder Bilder testest.
Provider: Custom
Endpoint: https://api.wokey.ai
API key: YOUR_API_KEY
Model: deepseek-v4.1-flash
Tool calling: On
Image input: On
Reasoning mode: Off
Custom protocol: OffAPI-Formate und Base URLslink
Wechselt ein Client das API-Format, kann sich ändern, ob die Base URL auf /v1 endet.
| Format | Base URL | Geeignet für |
|---|---|---|
| OpenAI Chat Completions | https://api.wokey.ai | DeepSeek, GLM, Kimi und andere Modelle |
Wo es konfiguriert wird: Einstellungen → Modelle → Benutzerdefinierte Modelle
Häufige Problemelink
- 404: Lass den Endpunkt auf https://api.wokey.ai und das eigene Protokoll aus. Nur wenn das eigene Protokoll an ist, trägst du den vollständigen Pfad https://api.wokey.ai/v1/chat/completions ein.
- 401: Füg nur den Key selbst in das Feld für den API-Key ein, ohne das Präfix Bearer. Prüf, ob der Key aktiv ist und das Konto Guthaben hat.
- model_not_found: Setz die Modell-ID auf deepseek-v4.1-flash, ohne Leerzeichen oder zusätzliche Suffixe.
- Bildanfragen schlagen fehl: Wähl deepseek-v4.1-flash und aktiviere die Bildeingabe. deepseek-v4-flash akzeptiert nur Text.
- 429, 502, 504 oder 529: Verringere die Parallelität, kürze den Kontext oder versuch es später erneut; du kannst auch auf ein anderes verfügbares Modell wechseln.
Mit curl prüfenlink
Meldet der Client einen Fehler, schließ zuerst mit curl Probleme mit Key und Base URL aus.
WorkBuddy nutzt standardmäßig das Format OpenAI Chat Completions. Antwortet diese Anfrage mit 200, stimmen Key und Base URL. Ersetze vor dem Senden YOUR_API_KEY durch deinen Key.
curl https://api.wokey.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4.1-flash",
"messages": [
{ "role": "user", "content": "Hello" }
]
}'Fehler und Fehlerbehebunglink
Unterscheide zuerst zwischen Authentifizierung, Guthaben, Rate-Limit, nicht verfügbarem Modell und Upstream-Timeout.
invalid api key
Der Key fehlt, ist falsch geschrieben oder gelöscht, oder die Header Authorization und x-api-key widersprechen sich.
insufficient balance
Das Guthaben des Kontos reicht nicht aus. Lade Guthaben auf, bevor du weitere Anfragen sendest.
model_denylisted / account_restricted
Aufrufe des Modells oder aller Modelle des Kontos sind nach wiederholten Verstößen pausiert. Siehe „Bearbeitungsgebühren für Verstöße und Einschränkungen“.
request_blocked
Diese Anfrage wurde blockiert, bevor sie den Upstream erreicht hat, und wird nicht berechnet – etwa das unveränderte erneute Senden einer Anfrage, die das Modell gerade abgelehnt hat, oder ein pausierter Endnutzer (X-End-User-Id). Die Fehlermeldung nennt, was blockiert ist; ändere die Anfrage entsprechend oder versuch es später erneut. Andere Anfragen sind nicht betroffen.
rate limited
Zu viele Anfragen in kurzer Zeit. Versuch es später erneut oder verringere die Parallelität. Liefert nur ein Modell oder ein Endnutzer (X-End-User-Id) dauerhaft 429, kann das ein vorübergehendes Limit nach Verstößen sein.
client disconnected
Der Client hat die Verbindung geschlossen, bevor die Antwort fertig war (Code downstream_aborted). Das ist standardmäßig kostenlos. Hat ein Konto in den letzten 24 Stunden mindestens 50 Client-Abbrüche und machen diese 10 % oder mehr seiner Anfragen aus, werden spätere abgebrochene Anfragen nach der vom Upstream gemeldeten Nutzung berechnet: die verarbeitete Eingabe einschließlich Cache-Lesen und Cache-Schreiben sowie Ausgabe nur, wenn der Upstream sie gezählt hat. Ein Abbruch, bevor der Upstream Nutzung gemeldet hat, bleibt kostenlos. Das Konto wird benachrichtigt, wenn die Berechnung beginnt, und sie endet automatisch innerhalb einer Stunde, sobald die Abbruchquote wieder normal ist. Die übliche Ursache ist ein zu kurzer Timeout im Client oder Proxy oder ein Programm, das Anfragen abbricht, bevor sie fertig sind.
upstream unavailable
Der Upstream-Modelldienst ist vorübergehend nicht verfügbar. Wechsle das Modell oder versuch es später erneut.
upstream timeout
Die Antwort des Upstreams hat zu lange gedauert. Kürze den Kontext, verringere max_tokens oder versuch es erneut.
upstream overloaded
Das Upstream-Modell ist vorübergehend überlastet, und Wokey hat es bereits über andere Routen erneut versucht (Code upstream_overloaded). Mit deinem Guthaben hat das nichts zu tun. Versuch es in Kürze erneut oder wechsle das Modell.
Häufige Fragenlink
- Soll die API-Adresse in WorkBuddy auf /v1 enden?
- Nein. Verwende https://api.wokey.ai und lass den Schalter für das benutzerdefinierte Protokoll aus. Nur bei eingeschaltetem benutzerdefiniertem Protokoll trägst du die vollständige Adresse https://api.wokey.ai/v1/chat/completions ein; passen beide nicht zusammen, kommt 404 zurück.
- Was gehört in den Modellnamen?
- Die exakte Modell-ID, zum Beispiel deepseek-v4.1-flash, ohne Leerzeichen oder Suffix. Alles andere liefert model_not_found.
- Warum schlagen Anfragen mit Bildern fehl?
- Prüfe, ob das Modell deepseek-v4.1-flash ist und der Schalter für die Bildeingabe eingeschaltet ist. deepseek-v4-flash ist ein Textmodell, schalte die Bildeingabe also aus, wenn du es verwendest.