Wokey API mit DeepSeek Harness nutzen

1. 1

   Vorabversion 0.2.1 installieren

   Der npm-Tag latest steht noch auf 0.2.0; DeepSeek empfiehlt für V4.1-Flash-1017 die Version v0.2.1-rc.1 oder neuer, installiere also @next.

2. 2

   Variable für den API-Key setzen

   Die Konfiguration nennt nur apiKeyEnv, der Key landet also nie in der Datei. Du kannst den Key auch in der Web-Oberfläche unter Settings → Models speichern.

3. 3

   Provider hinzufügen

   Bearbeite ~/.dsh/profiles/web/cordis.patch.yml (profiles/headless für dsh headless). Dieses Beispiel nutzt für beide Modelle Anthropic Messages, mit https://api.wokey.ai als Base URL. Wählst du stattdessen OpenAI Chat Completions, leg einen eigenen Provider an und nutze https://api.wokey.ai/v1.

4. 4

   Bildeingabe deklarieren

   DeepSeek Harness behandelt ein eigenes Modell ohne Deklaration als reines Textmodell und kann ein Bild deshalb ablehnen, bevor Wokey die Anfrage sieht – auch wenn das Wokey-Modell Bilder versteht. Für Opus 5.5, Haiku 5.5 oder jedes andere Vision-Modell ergänze unter dem Modell input: [text, image]; in der Oberfläche geht das über Settings → Models → Provider bearbeiten → Customized settings → Modellzeile aufklappen → Input types → Image. Speichere und starte dann eine neue Sitzung.

5. 5

   Vorhandene Provider behalten

   Dieser Override ersetzt die gesamte Konfiguration des Eintrags llm-pi-ai; hast du in der Oberfläche schon Provider hinzugefügt, führ sie also ebenfalls unter providers auf. Rück jedes input mit Leerzeichen ein und misch keine Tabs ins YAML. Starte nach dem Speichern eine neue Sitzung.

# 1. 0.2.1 installieren oder darauf aktualisieren
npm install -g @deepseek-ai/dsh@next
export WOKEY_API_KEY="YOUR_API_KEY"

# 2. ~/.dsh/profiles/web/cordis.patch.yml
- id: llm-pi-ai
  config:
    providers:
      wokey:
        displayName: Wokey
        apiKeyEnv: WOKEY_API_KEY
        api: anthropic-messages
        baseURL: https://api.wokey.ai
        models:
          - id: claude-opus-5-5
            name: Claude Opus 5.5
            contextWindow: 1000000
            input: [text, image]
          - id: deepseek-v4.1-flash
            name: DeepSeek-V4.1-Flash
            contextWindow: 1000000
            maxTokens: 393216
            input: [text, image]
- id: agent-default-model
  config:
    provider: wokey
    model: claude-opus-5-5

# 3. Starten
dsh web

Wo es konfiguriert wird: ~/.dsh/profiles/web/cordis.patch.yml

Wokey stellt die auf dieser Seite genannten Inferenz-Schnittstellen des Modells bereit, keine eigenständigen Endpunkte /v1/tools/search oder /v1/tools/fetch. Tool-Use-Unterstützung bedeutet nicht, dass jedes eingebaute Web-Tool des Upstreams unterstützt wird. Serverseitige Suche innerhalb von Modellanfragen hängt von der tatsächlichen Route ab und ist derzeit keine geprüfte, einheitlich unterstützte Wokey-Funktion; diese Seite nennt keinen Wokey-Preis pro Search/Fetch-Aufruf. Für dokumentiertes eigenständiges Suchen und Abrufen nutze einen DeepSeek-API-Key mit api.deepseek.com – getrennt von Wokey-Modellaufrufen konfiguriert und abgerechnet.

• “The current model does not support images”: Das ist die lokale Fähigkeitsprüfung von Harness; es bedeutet nicht, dass Wokey oder Opus 5.5 keine Bilder versteht. Aktiviere Image für das Modell oder ergänze input: [text, image] in seinem YAML-Eintrag.
• Bilder werden nach dem Speichern weiterhin abgelehnt: Starte eine neue Sitzung und wähl das Modell erneut aus; eine bestehende Sitzung behält die gespeicherten Modellfähigkeiten und Anhänge.
• Die Bildanfrage liefert 400: Protokoll und Base URL müssen zusammenpassen. Anthropic Messages nutzt https://api.wokey.ai ohne /v1; OpenAI Chat Completions nutzt https://api.wokey.ai/v1. deepseek-v4.1-flash unterstützt beide Formate, der Client muss aber die Struktur des gewählten Protokolls senden.
• Die App startet nicht oder meldet eine YAML-Zeilennummer: Prüf, ob input unter dem richtigen Modell eingerückt ist, alle Modell-Spiegelstriche auf einer Höhe stehen und die Datei keine Tabs enthält. Stell ein Backup wieder her und speichere es dann nur mit Leerzeichen neu.
• Die App startet mit “Select a model”: Prüf, ob agent-default-model noch auf einen vorhandenen Provider und ein vorhandenes Modell zeigt. Passe es an, nachdem du einen Provider gelöscht oder umbenannt hast.
• Das Modell erscheint nach der Erkennung, hat aber keine Bildfähigkeit: Fetch available models füllt vor allem IDs und Kapazitätsfelder. Deklariere input: [text, image] ausdrücklich für jedes eigene Vision-Modell, statt alle Modelle als bildfähig zu markieren.
• Andere Provider sind nach dem Speichern verschwunden: Ein Override in cordis.patch.yml ersetzt den gesamten Eintrag llm-pi-ai, behalte also alle vorhandenen Provider unter providers.

DeepSeek Harness 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" }
    ]
  }'

Soll die baseURL von DeepSeek Harness auf /v1 enden?

Das hängt vom Feld api des Providers ab. Bei anthropic-messages verwendest du https://api.wokey.ai ohne /v1; für OpenAI Chat Completions brauchst du einen eigenen Provider mit https://api.wokey.ai/v1.

Warum heißt es, das aktuelle Modell unterstütze keine Bilder?

Das ist eine lokale Fähigkeitsprüfung im Harness: Benutzerdefinierte Modelle deklarieren standardmäßig nur Texteingabe. Ergänze im Modelleintrag input: [text, image], speichere und versuche es in einer neuen Sitzung erneut.

Warum sind meine anderen Provider nach dem Speichern verschwunden?

Der Override für llm-pi-ai in cordis.patch.yml ersetzt den gesamten Eintrag. Trage die Provider, die du bereits hattest, zusammen mit Wokey unter providers ein.