DeepSeek Harness

Settings → Models → “Add model provider” → “Custom model API” beş alan alır — Provider ID, display name, base URL, API protocol ve API key — ve Claude ile GPT'yi yerleşik DeepSeek kartıyla aynı seçiciye koyar.

# 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

Adım adım

1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
2. Web Arayüzünü (dsh web) başlatıp Ayarlar → Modeller bölümüne gidin. Model sağlayıcısı ekle seçeneğini belirleyin. Kart, yalnızca dsh ile birlikte gelen sağlayıcıları listeleyen Üçüncü taraf model sağlayıcısı seçeneğinde açılır; bunu Özel model API'si olarak değiştirin.
3. Sağlayıcı kimliği (küçük harfle ve kalıcı olmalıdır; belgelere göre istekler, kaydedilmiş oturumlar, model varsayılanları ve kimlik bilgisi referanslarının tümü bunu kullanır; adını değiştirmek için yeni bir sağlayıcı ekleyip eskisini silmeniz gerekir), görünen ad, temel URL https://api.kunavo.com/v1, API protokolü OpenAI Chat Completions ve API anahtarı alanlarını doldurun. Anahtar yalnızca yazılabilir; dsh anahtarı $DSH_HOME/.credentials.yaml içinde tutar ve profil dosyasında yalnızca ona bir referans saklar.
4. Model kataloğu altında Kullanılabilir modelleri getir seçeneğini belirleyin. Kunavo GET /v1/models yanıtı verdiğinden model seçici otomatik olarak dolar. İstediğiniz modelleri işaretleyip Seçilenleri ekle seçeneğini belirleyin. Kimlikleri elle yazmak da aynı şekilde çalışır; belgeler, keşif hiçbir şey listelemediğinde bu yönteme geçilmesini söylüyor.
5. İsteğe bağlı: Claude kimliklerini Anthropic'in kendi protokolü üzerinden kullanmak için kendi Sağlayıcı Kimliği, temel URL'si https://api.kunavo.com — /v1 olmadan — ve Anthropic Messages API protokolü bulunan ikinci bir özel model API'si ekleyin; aynı anahtarı kullanın. Buradaki Getir seçeneği de tüm kataloğu listeler; yalnızca claude- kimliklerini ekleyin (neden yalnızca bunlar).
6. Oluşturucuda bir model seçin ve selamlaşma yerine bir dosyaya dokunan bir tur gönderin. Harness, yaptığı işlerin çoğunda araç çağrısına dayanır; bu nedenle bir şeyi okuyup düzenleyen ilk çalıştırma size daha fazla bilgi verir. Model değişiklikleri bir sonraki istekte geçerli olur; belgelere göre yeniden başlatma gerekmez.

DeepSeek Harness “Modelleri yapılandırma” sayfası (docs/user/guide/providers.md dosyasındaki dsh-v0.2.0-rc.2 etiketiyle aynı metin) ile 1 Ekim 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar DeepSeek Harness içinde çalışır.

# 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-..."

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Anthropic Messages üzerinden Claude

Kunavo Anthropic Messages API'sini de yanıtlar ve anthropic-messages, formun sunduğu üç protokolden biridir. Harness belgelerinde açıkça şöyle denir: “Bir sağlayıcı tek bir protokol kullanır; dolayısıyla iki protokol sunan bir ağ geçidi için iki sağlayıcı gerekir.” Yani bu, ilk sağlayıcının bir ayarı değil, onun yanındaki ikinci bir sağlayıcıdır.

• Temel URL https://api.kunavo.com, yalın kök adres olmalıdır. Çalıştırmada bu kök, /v1/messages?beta=true adresine istek gönderdi; bu, Claude Code'un da kullandığı ve Kunavo'nun yanıt verdiği yoldur. Sonuna /v1 eklendiğinde istek /v1/v1/messages adresine gitti. DeepSeek Harness ile Claude Code karşılaştırması iki istemcinin isteklerini yan yana gösterir.
• Yalnızca Claude kimlikleri. Kunavo'nun /v1/messages hizmeti yalnızca claude- kimliklerini sunar; orada bir gpt- kimliği kullanıldığında 404 döner ve bu yanıt /v1/chat/completions bilgisini belirtir. GPT'yi openai-completions sağlayıcısında tutun.
• Getir tüm modelleri listeler; yalnızca Claude modellerini ekleyin. dsh'nin llm-pi-ai README dosyasında, bu protokolde keşfin Anthropic'in x-api-key başlığıyla GET /v1/models adresine istek gönderdiği belirtilir. Kunavo'nun model listesi de Authorization: Bearer başlığında olduğu gibi bu başlıktaki anahtarı kabul eder. Bu bilgi dsh'nin kaynak kodundan ve Kunavo'nun kendi testlerinden gelir, bu çalıştırmadan değil. Kullanılabilir modelleri getir seçeneğinin döndürdüğü sonuçta GPT ve görsel modelleri de dâhil tüm katalog bulunur; bu nedenle yalnızca claude- kimliklerini işaretleyin. Bunları elle yazmak da aynı şekilde çalışır. Tam bir listenin gösterdiği şey göründüğünden azdır: aynı README dosyasına göre listeleme URL'si, sonunda /v1 olsun veya olmasın kabul edilir; model isteklerinde ise temel URL değiştirilmeden kullanılır. Bu nedenle Getir, listeyi https://api.kunavo.com/v1 adresinden de doldurur ve bu temel URL'den yapılan ilk tur /v1/v1/messages adresine gider.
• Ne sağlar? İstek Anthropic'in biçiminde ulaşır; çalıştırmada sistem istemi üst düzey system alanında taşındı, dolayısıyla developer rolü kullanılmaz. Kunavo, isteği OpenAI biçiminden dönüştürmek yerine olduğu gibi iletir. openai-completions sağlayıcısı aynı Claude kimliklerine çeviri yoluyla erişir; adımlarda yer almasının nedeni budur.

Formun arkasındaki dosya

Modeller sayfası $DSH_HOME/profiles/<profile>/cordis.patch.yml dosyasına yazar — bu dosya, $DSH_HOME/profiles/web/cordis.patch.yml yolundadır; başlangıç komutunuz dsh web olduğunda bu yol kullanılır. Eski dsh belgeleri $DSH_HOME/settings.yaml dosyasını gösteriyordu; 0.2.0-rc.2 belgeleri göstermiyor. Tarayıcı sunucuyla aynı makinedeyse, Ayarlar başlığındaki Yapılandırma dosyasını aç seçeneği dosyayı açar ve bağdaştırıcılar bir sonraki istekte dosyayı yeniden okur. Bu uç nokta için beş unsur önemlidir:

1. Bağlam penceresi ve azami çıktı token sayısı — formda Özelleştirilmiş ayarlar → Model seçenekleri altında. Elle yazılan bir kimlik bu değerleri taşımaz; bu nedenle rotanın varsayılanları geçerli olur: llm-pi-ai README dosyasına göre 262,144 bağlam token'ı ve 32,768 çıktı token'ı. Çalıştırmada iki özel sağlayıcı da tam olarak max_tokens: 32768 istedi. Yukarıdaki tablodaki her kimlik daha fazlasını alabilir; her durumda satırı kontrol edin ve daha fazlasını istiyorsanız bunları modelin katalog kaydından yükseltin. Kunavo, sınırın değil modelin ürettiği token'ların ücretini alır.
2. compat.supportsDeveloperRole — gerekli değil. Harness bunu developer rolünü kabul etmeyen ağ geçitleri için önerir; Kunavo ise Claude dâhil her model ailesinde bu rolü sistem turu olarak okur. (2026-09-30 tarihine kadar Claude yolu bu rolü düşürüyordu ve bu madde geçişi ayarlamanızı söylüyordu; açık kalması sorun yaratmaz.)
3. compat.maxTokensField — değiştirmeden bırakın. Harness bunu yukarıdaki geçişle birlikte olağan ilk çözüm olarak sunar; ancak Kunavo'nun kendi işleyicisi max_completion_tokens alanını okur ve bu alan yoksa max_tokens alanını kullanır, dolayısıyla varsayılan zaten çalışır.
4. reasoningEfforts — formda alan yoktur. Elle girdiğiniz bir model hiçbir düzey tanımlamaz; bu nedenle Çaba menüsü görünmez ve modelin düşünüp düşünmeyeceğine uç noktanın kendi varsayılanı karar verir. Menüyü istiyorsanız düzeyleri kendiniz tanımlayın; openai-completions yapılandırmasında her anahtar bir düzey, değeri ise reasoning_effort olarak gönderilen yazımdır. Bu, gpt- kimliğine ulaşır; claude- kimliğinde ise etkisi olmaz, çünkü Kunavo'nun sohbet arayüzü reasoning_effort parametresini Anthropic'e iletmez (/docs/chat#reasoning).
5. Girdi türleri (dosyada input: [text, image]) — belgeler bunun “uç noktanızla ilgili bir iddia belirttiğini, onu denetlemediğini” açıkça söyler. Görsel almayan bir kimlikte Görsel'i işaretlemek Harness tarafından saptanmaz; istek ileride reddedilir. Kutuyu işaretlemeden önce /models'de kimliği kontrol edin.

Bir oturumun gönderdiği diğer şeyler — tur başına 24 araç tanımı, her yeni oturum için kısa bir başlık isteği ve DeepSeek'in kendi rotasındaki ek alanlar — DeepSeek Harness fiyatlandırması sayfasında ölçülür.