Menggunakan Wokey API di DeepSeek Harness

1. 1

   Instal pra-rilis 0.2.1

   Tag latest di npm masih 0.2.0; DeepSeek menyarankan v0.2.1-rc.1 atau lebih baru untuk V4.1-Flash-1017, jadi instal @next.

2. 2

   Atur variabel API key

   Konfigurasi hanya menyebut apiKeyEnv, sehingga key tidak pernah tersimpan di file. Anda juga bisa menyimpan key di Settings → Models pada antarmuka web.

3. 3

   Tambahkan provider

   Edit ~/.dsh/profiles/web/cordis.patch.yml (profiles/headless untuk dsh headless). Contoh ini memakai Anthropic Messages untuk kedua model, dengan https://api.wokey.ai sebagai base URL. Jika Anda memilih OpenAI Chat Completions, buat provider terpisah dan gunakan https://api.wokey.ai/v1.

4. 4

   Deklarasikan input gambar

   DeepSeek Harness memperlakukan model kustom yang tidak dideklarasikan sebagai model teks saja, sehingga gambar bisa ditolak sebelum Wokey melihat request-nya, meskipun model Wokey tersebut mendukung vision. Untuk Opus 5.5, Haiku 5.5, atau model vision lainnya, tambahkan input: [text, image] di bawah model tersebut; di antarmuka, gunakan Settings → Models → edit provider → Customized settings → buka baris model → Input types → Image. Simpan, lalu mulai sesi baru.

5. 5

   Pertahankan provider yang sudah ada

   Override ini menggantikan seluruh konfigurasi entri llm-pi-ai, jadi jika Anda sudah menambahkan provider di antarmuka, cantumkan juga di bawah providers. Gunakan spasi untuk setiap indentasi input dan jangan mencampur tab ke dalam YAML. Mulai sesi baru setelah menyimpan.

# 1. Instal atau perbarui ke 0.2.1
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. Jalankan
dsh web

Lokasi konfigurasi: ~/.dsh/profiles/web/cordis.patch.yml

Wokey menyediakan antarmuka inferensi model yang tercantum di halaman ini, bukan endpoint mandiri /v1/tools/search atau /v1/tools/fetch. Dukungan tool calling tidak berarti setiap tool web bawaan upstream didukung. Pencarian sisi server di dalam request model bergantung pada rute pasokan yang sebenarnya dan saat ini tidak tercantum sebagai kemampuan Wokey yang terverifikasi dan didukung secara seragam; halaman ini tidak memublikasikan harga Wokey per panggilan Search/Fetch. Untuk dukungan pencarian dan fetch mandiri yang terdokumentasi, gunakan API key DeepSeek dengan api.deepseek.com, yang dikonfigurasi dan ditagih terpisah dari panggilan model Wokey.

• “The current model does not support images”: ini adalah pemeriksaan kemampuan lokal di Harness; bukan berarti Wokey atau Opus 5.5 tidak mendukung vision. Aktifkan Image untuk model tersebut, atau tambahkan input: [text, image] ke entri YAML-nya.
• Gambar masih ditolak setelah menyimpan: mulai sesi baru dan pilih kembali modelnya; sesi yang sudah ada mempertahankan kemampuan model dan lampiran yang tercatat.
• Request gambar mengembalikan 400: cocokkan protokol dan base URL. Anthropic Messages memakai https://api.wokey.ai tanpa /v1; OpenAI Chat Completions memakai https://api.wokey.ai/v1. deepseek-v4.1-flash mendukung kedua format, tetapi klien tetap harus mengirim struktur sesuai protokol yang dipilih.
• Aplikasi tidak mau berjalan atau melaporkan nomor baris YAML: periksa apakah input berada di bawah model yang dimaksud, semua tanda hubung model sejajar, dan file tidak berisi tab. Pulihkan cadangan, lalu simpan lagi hanya dengan spasi.
• Aplikasi terbuka dengan “Select a model”: periksa apakah agent-default-model masih menunjuk ke provider dan model yang ada. Perbarui setelah menghapus atau mengganti nama provider.
• Model muncul setelah discovery tetapi tidak memiliki kemampuan gambar: Fetch available models terutama mengisi ID dan field kapasitas. Deklarasikan input: [text, image] secara eksplisit untuk setiap model vision kustom, alih-alih menandai semua model mendukung vision.
• Provider lain hilang setelah menyimpan: override di cordis.patch.yml menggantikan seluruh entri llm-pi-ai, jadi pertahankan semua provider yang sudah ada di bawah providers.

DeepSeek Harness secara default memakai format OpenAI Chat Completions. Jika request ini mengembalikan 200, berarti API key dan base URL sudah benar. Ganti YOUR_API_KEY dengan key Anda sebelum mengirimnya.

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

Apakah baseURL DeepSeek Harness perlu diakhiri /v1?

Tergantung kolom api pada provider. Dengan anthropic-messages gunakan https://api.wokey.ai tanpa /v1; OpenAI Chat Completions memerlukan provider terpisah dengan https://api.wokey.ai/v1.

Mengapa muncul pesan bahwa model saat ini tidak mendukung gambar?

Itu pemeriksaan kemampuan lokal di Harness: secara default, model kustom hanya mendeklarasikan input teks. Tambahkan input: [text, image] ke entri model, simpan, lalu coba lagi di sesi baru.

Mengapa provider saya yang lain hilang setelah disimpan?

Override llm-pi-ai di cordis.patch.yml menggantikan seluruh entri. Tuliskan provider yang sudah Anda miliki ke dalam providers bersama Wokey.