Jan Agent

Tek bir `jan config set --base-url https://api.kunavo.com/v1` satırı Kunavo'yu ~/.jan/config.toml dosyasına yazar; çıkarım motoru içermeyen Jan Agent önizleme CLI'sı bu anahtarla çalışır.

# Jan Agent is a preview on a nightly channel — check your build first.
jan --version

jan config set \
  --provider kunavo \
  --api-key sk-kn-... \
  --base-url https://api.kunavo.com/v1 \
  --model claude-sonnet-5 \
  --model claude-haiku-4-5 \
  --api-type openai

jan config list   # configured providers as JSON, keys redacted

Adım adım

1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
2. Neyi yapılandırdığınızı kontrol edin: jan --version. Jan Desktop'ta jan olarak çağrılan bir CLI de bulunur, ancak komut kümesi farklıdır. Bu nedenle devam etmeden önce jan config set --help komutunun --base-url listelediğini doğrulayın.
3. Yukarıdaki jan config set satırını çalıştırın. --provider, sabit bir listedeki ad değil, sizin seçtiğiniz bir kimliktir; belgelerdeki yerel donanım örneğinde --provider local kullanılır. --model yinelenebilir ve yeni bir listeye ekleme yapmak yerine mevcut listenin tamamını değiştirir.
4. Gizli anahtarlarla birlikte yapılandırmanın uygulandığını jan config list ile veya dosyanın kendisi için jan config path ile doğrulayın; ardından tüm sağlayıcıların sunduklarını görmek için jan cli models list çalıştırın. Elle girilmiş bir model kimliği, uç nokta onu listelemeyi bıraksa da kalır; jan cli models refresh --provider kunavo ise uç noktanın listesini esas alır.
5. Bir projeye geçin, jan komutunu çalıştırın ve ardından /model ile modeli seçin. İlk çalıştırmada jan --plan komutunu tercih edin: salt okunurdur, bu nedenle protokol uyuşmazlığı diske bir şey yazılmadan ortaya çıkar.
6. Bir dosyayı düzenleyen görev verin. Jan Agent bir aracı olduğundan, ilk çalıştırmada araç çağrısı ve akışı sınayın; yalnızca kısmen uyumlu bir uç noktada ilk bozulacak şeyler bunlardır, selamlaşma ise ikisini de sınamaz.

Jan Agent'ın Providers sayfası ile 21 Eylül 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 Jan Agent 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ış.

Jan API anahtarı adı verilen iki farklı şey var

İkisi aynı dosyada yer alır ve birbirinin zıddı anlam taşır; bu nedenle jan config list, diğerini bekleyen birine yanlış görünebilir.

Jan Desktop ikisini de sağlamaz: hesabı yoktur, dolayısıyla oluşturacak bir şey de yoktur. Yerel API sunucusu, sizin uydurduğunuz bir anahtar ister; bu da ifadenin üçüncü bir anlamıdır ve başka bir ana makineye aittir.

Jan Desktop'ın sağladıkları ve bunların kapsamı

Jan Agent, sağlayıcı ayarları için her biri kendisinden önce geleni geçersiz kılan dört kaynağı okur; bunlardan ikincisi insanları şaşırtır.

1. ~/.jan/config.toml — temel yapılandırma ve jan config set tarafından yazılan tek dosya.
2. Jan Desktop'ın settings.json dosyası — yalnızca devralınır. Agent'ta yapılandırmadığınız sağlayıcıları ekler, yapılandırdığınız hiçbir sağlayıcıyı geçersiz kılmaz ve hiçbir zaman bu dosyaya geri yazılmaz.
3. Bir projenin agent.toml dosyasındaki [provider] bloğu — proje başına açık bir seçim olduğundan ikisini de geçersiz kılar. Bu dosya genellikle depoya kaydedilir, bu yüzden api_key değerini dosyaya koymayın.
4. Komut satırında --provider / --api-key ya da JAN_API_KEY / <PROVIDER>_API_KEY — en açık ve en geçici seçenek.

Yanlış şeyi hata ayıklamadan önce bilmenizde fayda olan iki sonuç var. jan config list, sağlayıcı olmadığını bildirebilirken jan cli models list birçok sağlayıcı döndürebilir — ikinci komut, ~/.jan/config.toml içinde saklanmayan ve Desktop'tan devralınanları da içerir. Ayrıca devralınan bir sağlayıcı hiçbir zaman yenilenmez; burada yeniden yazılacak bir girdi yoktur. Kunavo'nun model listesinin güncel kalmasını istiyorsanız, yukarıdaki bloğun oluşturduğu gibi, ayrıca bir jan config set girdisi oluşturmanız gerekir.

İki sağlayıcı aynı model kimliğini sunduğunda

Kunavo claude-sonnet-5 gibi kimlikler sunar; doğrudan satıcıya yönlendirilen bir sağlayıcı girdisi de aynı kimlikleri sunabilir. Jan Agent bunlardan birini seçmek zorundadır. Belgelenmiş öncelik sırası şöyledir: önce sağlayıcının models listesindeki tam eşleşme, ardından yapılandırılmış bir sağlayıcıyı adlandıran <provider>/<model> öneki; aynı kimliği birden fazla sağlayıcı sunuyorsa kimlik bilgisi olan sağlayıcı anahtarsız eşinden önce gelir. Dolayısıyla hangisini kastettiğinizi belirtmek için kunavo/claude-sonnet-5 kullanılır. Bu niteleyici yalnızca Jan içindir — yukarı akış hizmetleri sağlayıcı nitelemeli kimlikleri reddettiğinden istek gönderilmeden önce kaldırılır.

Aynı girdi, konsol içinden

Bayrakları yazmak istemiyorsanız: /settings > providers, aynı ~/.jan/config.toml girdilerini yönetir; a ise alanları name, base url, api key ve boşlukla ayrılmış models olan bir ekleme formu açar. Formun bayraklarda olmayan iki özelliği var: ana URL https:// olmalıdır (localhost uç noktası içinse http://), böylece anahtar uzak bir bağlantı üzerinden düz metin olarak gönderilmez — Kunavo https:// olduğundan bu bir engel değildir — ayrıca düzenleme sırasında API anahtarı alanı (unchanged) gösterir ve siz alana bir şey yazmadıkça kayıtlı değeri korur. Alanı boş bırakmak anahtarı olduğu gibi bırakmaz, siler.