İstemciler/WorkBuddy

WorkBuddy ile Wokey API kullanımı

Bir Wokey API anahtarı alın, WorkBuddy için base URL olarak Wokey’yi girin ve bağlantıyı tek bir curl isteğiyle doğrulayın.

Güncellendi

Bu sayfadaexpand_more

API anahtarını ve base URL’yi hazırlayınlink

Tüm istemciler aynı Wokey API anahtarını ve aynı base URL’yi kullanır.

API anahtarı oluşturun

Giriş yapın ve API sayfasında bir platform anahtarı oluşturun. Aynı hesaptaki anahtarlar hesabın bakiyesini paylaşır.

API anahtarı oluşturkey

Wokey base URL’sini kullanın

İstemcinin base URL’si olarak gateway alan adını girin; /v1 eklenip eklenmeyeceğini aşağıdaki yapılandırma gösterir.

İstemciyi yapılandırınlink

WorkBuddy, özel modeller için OpenAI Chat Completions kullanır. WorkBuddy’de Settings → Model → Custom models bölümünü açıp Wokey uç noktasını, API anahtarını ve deepseek-v4.1-flash değerini girin; araç çağrıları ve görsel girdisi böylece WorkBuddy görevlerinde ve agent iş akışlarında kullanılabilir.

  1. 1

    Model ayarlarını açın

    WorkBuddy’nin sol alt köşesindeki hesap düğmesine tıklayın → Settings → Model. Model seçiciyi açıp Configure custom model seçeneğini de kullanabilirsiniz.

  2. 2

    Özel model ekleyin

    Custom’ı seçin. Uç noktayı https://api.wokey.ai olarak ayarlayın, Wokey API anahtarınızı yapıştırın ve tam model kimliği olarak deepseek-v4.1-flash girin (eski deepseek-flash kimliği de çalışır).

  3. 3

    Yetenekleri ayarlayın

    Araç çağrılarını ve görsel girdisini etkinleştirin. Reasoning modunu ve özel protokolü kapalı bırakın. deepseek-v4.1-flash metin, görsel ve araçları kabul eder; bunun yerine deepseek-v4-flash kullanıyorsanız görsel girdisini kapatın, çünkü o model yalnızca metin kabul eder.

  4. 4

    Kaydedin ve modeli değiştirin

    Test connection’ı çalıştırın, modeli kaydedin, ardından konuşmadaki model seçiciden seçin. Araçları veya görselleri denemeden önce kısa bir metin prompt’uyla başlayın.

WorkBuddy
Provider: Custom
Endpoint: https://api.wokey.ai
API key: YOUR_API_KEY
Model: deepseek-v4.1-flash
Tool calling: On
Image input: On
Reasoning mode: Off
Custom protocol: Off

API formatları ve base URL’lerlink

Bir istemci API formatını değiştirdiğinde base URL’nin /v1 ile bitip bitmeyeceği değişebilir.

FormatBase URLKullanım alanı
OpenAI Chat Completionshttps://api.wokey.aiDeepSeek, GLM, Kimi ve diğer modeller

Yapılandırıldığı yer: Settings → Models → Custom models

Sık karşılaşılan sorunlarlink

  • 404: uç noktayı https://api.wokey.ai olarak, özel protokolü de kapalı bırakın. Yalnızca özel protokol açıkken tam https://api.wokey.ai/v1/chat/completions yolunu girmeniz gerekir.
  • 401: API anahtarı alanına yalnızca anahtarın kendisini yapıştırın; Bearer önekini eklemeyin. Anahtarın etkin olduğunu ve hesapta bakiye bulunduğunu doğrulayın.
  • model_not_found: model kimliğini boşluk veya ek sonek olmadan deepseek-v4.1-flash olarak ayarlayın.
  • Görsel istekleri başarısız oluyor: deepseek-v4.1-flash modelini seçin ve görsel girdisini etkinleştirin. deepseek-v4-flash yalnızca metin kabul eder.
  • 429, 502, 504 veya 529: eşzamanlılığı azaltın, bağlamı kısaltın veya daha sonra yeniden deneyin; kullanılabilir başka bir modele de geçebilirsiniz.

curl ile doğrulayınlink

İstemci hata verirse önce curl ile anahtar ve base URL sorunlarını eleyin.

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

Hatalar ve sorun gidermelink

Önce kimlik doğrulama, bakiye, hız limiti, model kullanılabilirliği ve upstream zaman aşımı durumlarını ayırın.

401

invalid api key

Anahtar eksik, yanlış yazılmış veya silinmiş ya da Authorization ile x-api-key başlıkları çelişiyor.

402

insufficient balance

Hesap bakiyesi yetersiz. Daha fazla istek göndermeden önce bakiye yükleyin.

403

model_denylisted / account_restricted

Modele veya hesaptaki tüm modellere yapılan çağrılar, tekrarlanan ihlallerin ardından duraklatıldı. Bkz. “İhlal işlem ücretleri ve kısıtlamalar”.

403

request_blocked

Bu istek upstream’e ulaşmadan engellendi ve ücretlendirilmez; örneğin modelin az önce reddettiği bir isteğin değiştirilmeden yeniden gönderilmesi veya duraklatılmış bir son kullanıcı (X-End-User-Id). Hata mesajı neyin engellendiğini belirtir; isteği buna göre değiştirin veya daha sonra yeniden deneyin. Diğer istekler etkilenmez.

429

rate limited

İstekler çok sık. Daha sonra yeniden deneyin veya eşzamanlılığı azaltın. Yalnızca tek bir model ya da tek bir son kullanıcı (X-End-User-Id) sürekli 429 döndürüyorsa bu, ihlallerden sonra uygulanan geçici bir limit olabilir.

499

client disconnected

İstemci, yanıt tamamlanmadan bağlantıyı kapattı (kod downstream_aborted). Bu varsayılan olarak ücretsizdir. Bir hesabın son 24 saatte en az 50 istemci kopması olur ve bunlar isteklerinin %10’unu veya daha fazlasını oluşturursa, sonraki kopan istekler upstream’in bildirdiği kullanım üzerinden faturalandırılır: önbellek okuma ve yazma dahil işlenen girdi ve yalnızca upstream saydıysa çıktı. Upstream herhangi bir kullanım bildirmeden önceki kopma ücretsiz kalır. Faturalandırma başladığında hesaba bildirim gönderilir ve kopma oranı normale döndükten sonra bir saat içinde faturalandırma otomatik olarak durur. Olağan neden, çok kısa bir istemci veya proxy zaman aşımı ya da istekleri tamamlanmadan iptal eden bir programdır.

502

upstream unavailable

Upstream model hizmeti geçici olarak kullanılamıyor. Model değiştirin veya daha sonra yeniden deneyin.

504

upstream timeout

Upstream yanıtı zaman aşımına uğradı. Bağlamı kısaltın, max_tokens değerini düşürün veya yeniden deneyin.

529

upstream overloaded

Upstream model geçici olarak aşırı yüklü ve Wokey başka rotalarda zaten yeniden denedi (kod upstream_overloaded). Bunun bakiyenizle ilgisi yoktur. Kısa süre sonra yeniden deneyin veya model değiştirin.

Sık sorulan sorularlink

WorkBuddy API adresi /v1 ile bitmeli mi?
Hayır. https://api.wokey.ai kullanın ve özel protokol anahtarını kapalı tutun. Yalnızca özel protokol açıkken tam adresi, yani https://api.wokey.ai/v1/chat/completions adresini girersiniz; ikisi uyuşmazsa 404 döner.
Model adına ne yazılır?
Tam model kimliği, örneğin deepseek-v4.1-flash; boşluk veya son ek olmadan. Bunun dışındaki her şey model_not_found döndürür.
Görsel içeren istekler neden başarısız oluyor?
Modelin deepseek-v4.1-flash olduğunu ve görsel girdisi anahtarının açık olduğunu kontrol edin. deepseek-v4-flash bir metin modelidir; onu kullanırken görsel girdisini kapatın.