DeepSeek Harness

Settings → Models → “Add model provider” → “Custom model API” menerima lima field — Provider ID, display name, base URL, API protocol, dan API key — lalu menempatkan Claude dan GPT dalam pemilih yang sama dengan kartu DeepSeek bawaan.

# Settings → Models → Add model provider → Custom model API
#
#   Provider ID     kunavo          (lowercase, and permanent)
#   display name    Kunavo
#   base URL        https://api.kunavo.com/v1
#   API protocol    OpenAI Chat Completions   (openai-completions)
#   API key         sk-kn-...
#
# Then Model catalog → Fetch available models → Add selected,
# or type the ids by hand. The page writes the active profile's
# $DSH_HOME/profiles/<profile>/cordis.patch.yml — profile "web" under
# `dsh web`. The same provider there, plus an optional second one
# that sends Claude ids over Anthropic Messages, whose base URL has
# NO /v1. This entry replaces the whole llm-pi-ai config: keep any
# provider already in it.

- id: llm-pi-ai
  config:
    providers:
      kunavo:
        apiKeyEnv: KUNAVO_API_KEY
        api: openai-completions
        baseURL: https://api.kunavo.com/v1   # → /v1/chat/completions
        models:
          - id: claude-sonnet-5
          - id: claude-opus-5
          - id: claude-haiku-4-5
          - id: gpt-5-6-sol
      kunavo-claude:
        apiKeyEnv: KUNAVO_API_KEY
        api: anthropic-messages
        baseURL: https://api.kunavo.com      # → /v1/messages
        models:
          - id: claude-sonnet-5
          - id: claude-haiku-4-5

Langkah demi langkah

1. Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
2. Jalankan Web UI (dsh web) dan buka Pengaturan → Model. Pilih Tambah penyedia model. Kartu terbuka pada Penyedia model pihak ketiga, yang hanya menampilkan penyedia yang disertakan dalam dsh — ubah ke API model kustom.
3. Isi ID penyedia (huruf kecil dan permanen — dokumentasi menyebutkan bahwa permintaan, sesi tersimpan, default model, dan referensi kredensial semuanya menggunakannya; untuk mengganti nama, Anda harus menambahkan penyedia baru dan menghapus yang lama), nama tampilan, URL dasar https://api.kunavo.com/v1, protokol API OpenAI Chat Completions, dan kunci API. Kunci hanya bisa ditulis; dsh menyimpannya di $DSH_HOME/.credentials.yaml dan hanya menyimpan referensinya di profil.
4. Di bagian Katalog model, pilih Ambil model yang tersedia — Kunavo merespons dengan GET /v1/models, sehingga pemilih akan terisi otomatis. Centang model yang Anda inginkan, lalu pilih Tambahkan yang dipilih. ID yang dimasukkan secara manual juga berfungsi, dan dokumentasi menyarankan cara itu setiap kali penemuan model tidak menampilkan apa pun.
5. Opsional: untuk ID Claude melalui protokol Anthropic sendiri, tambahkan API model kustom kedua dengan ID Penyedia dan URL dasar tersendiri https://api.kunavo.com — tanpa /v1 — serta protokol API Anthropic Messages dan kunci yang sama. Pengambilan model juga menampilkan seluruh katalog di sini; tambahkan hanya ID claude- (mengapa hanya itu).
6. Pilih model di kolom penulisan, lalu kirim giliran yang menyentuh sebuah file, bukan sekadar sapaan — harness banyak mengandalkan pemanggilan alat, jadi pengujian pertama yang membaca dan mengedit sesuatu akan memberi Anda informasi lebih banyak. Perubahan model berlaku pada permintaan berikutnya; dokumentasi secara jelas menyatakan bahwa tidak perlu memulai ulang.

Diperiksa terhadap halaman “Configure models” DeepSeek Harness (teks yang sama dengan docs/user/guide/providers.md pada tag dsh-v0.2.0-rc.2) pada 1 Oktober 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di DeepSeek Harness.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

Claude melalui Anthropic Messages

Kunavo juga menjawab API Anthropic Messages, dan anthropic-messages adalah salah satu dari tiga protokol yang ditawarkan formulir. Dokumentasi harness dengan jelas menyatakan bahwa “Satu penyedia menggunakan satu protokol, jadi gateway yang melayani dua protokol memerlukan dua penyedia” — jadi ini adalah penyedia kedua di samping yang pertama, bukan pengaturan pada penyedia itu.

• URL dasar https://api.kunavo.com, root tanpa sufiks. Dalam pengujian, root tersebut mengirim permintaan ke /v1/messages?beta=true — path yang juga digunakan Claude Code dan dijawab oleh Kunavo. Jika ditambahkan /v1 di bagian akhir, permintaan dikirim ke /v1/v1/messages. DeepSeek Harness vs Claude Code membandingkan permintaan dari kedua klien secara berdampingan.
• Hanya ID Claude. /v1/messages Kunavo menyediakan ID claude- saja; ID gpt- di sana akan menghasilkan 404 yang menyebutkan /v1/chat/completions. Tetap gunakan penyedia openai-completions untuk GPT.
• Pengambilan model menampilkan setiap model; tambahkan hanya model Claude. README llm-pi-ai dsh menyebutkan bahwa penemuan model pada protokol ini mengirim permintaan ke GET /v1/models dengan header x-api-key milik Anthropic, dan daftar model Kunavo menerima kunci pada header tersebut seperti halnya di Authorization: Bearer — kesimpulan itu berasal dari kode sumber dsh dan pengujian Kunavo sendiri, bukan dari pengujian tersebut. Hasil yang diperoleh melalui Ambil model yang tersedia adalah seluruh katalog, termasuk GPT dan model gambar, jadi centang hanya ID claude-; memasukkannya secara manual juga berfungsi. Daftar lengkap tidak membuktikan sebanyak yang terlihat: README yang sama menyebutkan bahwa URL daftar diterima dengan atau tanpa /v1, sedangkan permintaan model menggunakan URL dasar tanpa perubahan — jadi pengambilan model juga mengisi daftar dari https://api.kunavo.com/v1, dan giliran pertama dari URL dasar itu dikirim ke /v1/v1/messages.
• Manfaatnya. Permintaan tiba dalam format Anthropic — dalam pengujian, prompt sistem dikirim sebagai kolom tingkat atas system, sehingga peran developer tidak digunakan — dan Kunavo meneruskannya apa adanya, alih-alih menerjemahkannya dari format OpenAI. Penyedia openai-completions menjangkau ID Claude yang sama melalui penerjemahan, itulah sebabnya penyedia tersebut digunakan dalam langkah-langkahnya.

File di balik formulir

Halaman Models menulis $DSH_HOME/profiles/<profile>/cordis.patch.yml — $DSH_HOME/profiles/web/cordis.patch.yml jika Anda memulai dengan dsh web. Dokumentasi dsh yang lebih lama menunjuk ke $DSH_HOME/settings.yaml; dokumentasi versi 0.2.0-rc.2 tidak. Jika browser berada di mesin yang sama dengan server, Buka file konfigurasi di header Settings akan membukanya, dan adaptor membacanya ulang pada permintaan berikutnya. Untuk endpoint ini, lima hal perlu diperhatikan:

1. Jendela konteks dan token keluaran maksimum — di formulir, pada Pengaturan yang disesuaikan → Opsi model. ID yang dimasukkan secara manual tidak membawa keduanya, sehingga nilai cadangan rute berlaku: konteks 262,144 token dan keluaran 32,768 token, menurut README llm-pi-ai — dan dalam pengujian, kedua penyedia kustom meminta tepat max_tokens: 32768. Setiap ID dalam tabel di atas mendukung nilai yang lebih besar; periksa barisnya, lalu tingkatkan dari entri katalog model jika Anda menginginkan nilai yang lebih besar. Kunavo menagihkan token yang ditulis model, bukan batasnya.
2. compat.supportsDeveloperRole — tidak diperlukan. Harness menyarankannya untuk gateway yang menolak peran developer; Kunavo membaca peran itu sebagai giliran sistem pada setiap keluarga, termasuk Claude. (Hingga 2026-09-30, jalur Claude menghilangkannya, dan item ini menyarankan Anda mengaktifkan sakelar tersebut — jika tetap aktif, itu tidak berbahaya.)
3. compat.maxTokensField — biarkan sebagaimana adanya. Harness memasangkannya dengan sakelar di atas sebagai perbaikan pertama yang lazim, tetapi penangan Kunavo sendiri membaca max_completion_tokens dan menggunakan max_tokens sebagai nilai cadangan, sehingga nilai default sudah berfungsi.
4. reasoningEfforts — tidak ada kolom untuknya di formulir. Model yang Anda masukkan secara manual tidak mendeklarasikan tingkat penalaran, sehingga menu Upaya tidak muncul dan default endpoint menentukan apakah model akan berpikir. Deklarasikan tingkatnya sendiri jika Anda menginginkan menu; pada openai-completions setiap kunci adalah satu tingkat, dan nilainya adalah penulisan yang dikirim sebagai reasoning_effort. Ini menjangkau ID gpt-; pada ID claude-, pengaturan ini tidak berpengaruh karena antarmuka obrolan Kunavo tidak meneruskan reasoning_effort ke Anthropic (/docs/chat#reasoning).
5. Jenis input (input: [text, image] di dalam file) — dokumentasi dengan jelas menyatakan bahwa ini “menyatakan klaim tentang endpoint Anda, bukan memeriksanya”. Mencentang Image pada ID yang tidak menerima gambar tidak akan terdeteksi oleh harness; permintaan akan ditolak lebih lanjut dalam proses. Periksa ID di /models sebelum mencentang kotak.

Bagian lain yang dikirim sesi — 24 definisi alat per giliran, permintaan judul singkat untuk setiap sesi baru, dan kolom tambahan pada rute DeepSeek sendiri — dihitung dalam Harga DeepSeek Harness.