DeepSeek Harness ile Wokey API kullanımı

1. 1

   0.2.1 ön sürümünü kurun

   npm’deki latest etiketi hâlâ 0.2.0; DeepSeek, V4.1-Flash-1017 için v0.2.1-rc.1 veya sonrasını önerir, bu yüzden @next sürümünü kurun.

2. 2

   API anahtarı değişkenini ayarlayın

   Yapılandırma yalnızca apiKeyEnv adını içerir, yani anahtar hiçbir zaman dosyaya yazılmaz. Anahtarı web arayüzünde Settings → Models altında da kaydedebilirsiniz.

3. 3

   Sağlayıcıyı ekleyin

   ~/.dsh/profiles/web/cordis.patch.yml dosyasını düzenleyin (dsh headless için profiles/headless). Bu örnek her iki model için de Anthropic Messages kullanır ve base URL olarak https://api.wokey.ai adresini alır. Bunun yerine OpenAI Chat Completions seçerseniz ayrı bir sağlayıcı oluşturun ve https://api.wokey.ai/v1 adresini kullanın.

4. 4

   Görsel girdisini tanımlayın

   DeepSeek Harness, tanımlanmamış özel bir modeli yalnızca metin modeli sayar; bu yüzden Wokey modeli görsel anlamayı desteklese bile görseli, istek Wokey’ye ulaşmadan reddedebilir. Opus 5.5, Haiku 5.5 veya başka bir vision modeli için o modelin altına input: [text, image] ekleyin; arayüzde Settings → Models → sağlayıcıyı düzenle → Customized settings → model satırını genişlet → Input types → Image yolunu kullanın. Kaydedin, ardından yeni bir oturum başlatın.

5. 5

   Mevcut sağlayıcıları koruyun

   Bu geçersiz kılma, llm-pi-ai girdisinin tüm yapılandırmasının yerini alır; arayüzde daha önce sağlayıcı eklediyseniz onları da providers altında listeleyin. Her input girintisinde boşluk kullanın ve YAML’a sekme karıştırmayın. Kaydettikten sonra yeni bir oturum başlatın.

# 1. 0.2.1 sürümünü kurun veya bu sürüme güncelleyin
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. Başlatın
dsh web

Yapılandırıldığı yer: ~/.dsh/profiles/web/cordis.patch.yml

Wokey, bu sayfada listelenen model çıkarım arayüzlerini sunar; bağımsız /v1/tools/search veya /v1/tools/fetch uç noktalarını sunmaz. Araç çağırma desteği, upstream’in her yerleşik web aracının desteklendiği anlamına gelmez. Model istekleri içindeki sunucu tarafı arama, gerçek tedarik rotasına bağlıdır ve şu anda doğrulanmış, tek tip desteklenen bir Wokey özelliği olarak listelenmez; bu sayfada çağrı başına bir Wokey Search/Fetch fiyatı yayımlanmaz. Belgelenmiş bağımsız arama ve fetch desteği için api.deepseek.com ile bir DeepSeek API anahtarı kullanın; bu, Wokey model çağrılarından ayrı yapılandırılır ve ücretlendirilir.

• “The current model does not support images”: bu, Harness’in yerel yetenek denetimidir; Wokey’nin veya Opus 5.5’in görsel anlamayı desteklemediği anlamına gelmez. O model için Image seçeneğini etkinleştirin veya YAML girdisine input: [text, image] ekleyin.
• Kaydettikten sonra görseller hâlâ reddediliyor: yeni bir oturum başlatıp modeli yeniden seçin; mevcut oturum, kayıtlı model yeteneğini ve ekleri korur.
• Görsel isteği 400 döndürüyor: protokol ile base URL’yi eşleştirin. Anthropic Messages, /v1 olmadan https://api.wokey.ai adresini kullanır; OpenAI Chat Completions ise https://api.wokey.ai/v1 adresini kullanır. deepseek-v4.1-flash iki formatı da destekler, ancak istemcinin yine de seçilen protokolün yapısını göndermesi gerekir.
• Uygulama başlamıyor veya bir YAML satır numarası bildiriyor: input alanının doğru modelin altında girintilendiğini, tüm model tirelerinin aynı hizada olduğunu ve dosyada sekme bulunmadığını kontrol edin. Bir yedeği geri yükleyin, ardından yalnızca boşluk kullanarak yeniden kaydedin.
• Uygulama “Select a model” ile açılıyor: agent-default-model değerinin hâlâ var olan bir sağlayıcıyı ve modeli gösterdiğini kontrol edin. Bir sağlayıcıyı sildikten veya yeniden adlandırdıktan sonra güncelleyin.
• Model keşiften sonra görünüyor ama görsel yeteneği yok: Fetch available models esas olarak kimlikleri ve kapasite alanlarını doldurur. Tüm modelleri görsel destekli olarak işaretlemek yerine, her özel vision modeli için input: [text, image] değerini açıkça tanımlayın.
• Kaydettikten sonra diğer sağlayıcılar kayboldu: cordis.patch.yml içindeki geçersiz kılma tüm llm-pi-ai girdisinin yerini alır; bu yüzden mevcut tüm sağlayıcıları providers altında tutun.

DeepSeek Harness varsayılan olarak OpenAI Chat Completions formatını kullanır. Bu istek 200 dönüyorsa anahtar ve base URL doğrudur. Göndermeden önce YOUR_API_KEY yerine kendi anahtarınızı yazın.

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

DeepSeek Harness baseURL değeri /v1 ile bitmeli mi?

Bu, sağlayıcının api alanına bağlıdır. anthropic-messages için /v1 olmadan https://api.wokey.ai kullanın; OpenAI Chat Completions için https://api.wokey.ai/v1 adresli ayrı bir sağlayıcı gerekir.

Neden mevcut modelin görselleri desteklemediği söyleniyor?

Bu, Harness içindeki yerel bir yetenek denetimidir: özel modeller varsayılan olarak yalnızca metin girdisi bildirir. Model girdisine input: [text, image] ekleyin, kaydedin ve yeni bir oturumda tekrar deneyin.

Kaydettikten sonra diğer sağlayıcılarım neden kayboldu?

cordis.patch.yml içindeki llm-pi-ai geçersiz kılması girdinin tamamını değiştirir. Daha önce sahip olduğunuz sağlayıcıları Wokey ile birlikte providers altına yazın.