Junie CLI

Junie CLI, özel uç noktayı $JUNIE_HOME/models/ içindeki JSON profili olarak alır; baseUrl eksiksiz uç nokta URL'sidir ve fasterModel yardımcı trafiğinin nereye gideceğini belirler.

{
  "id": "claude-sonnet-5",
  "baseUrl": "https://api.kunavo.com/v1/chat/completions",
  "displayName": "Kunavo",
  "providerName": "Kunavo",
  "apiType": "OpenAICompletion",
  "apiKey": "${KUNAVO_API_KEY}",
  "fasterModel": {
    "id": "claude-haiku-4-5"
  }
}

Adım adım

1. /app/keys adresinde anahtar oluşturup kopyalayın — yalnızca bir kez gösterilir. Junie'yi başlatacağınız kabukta KUNAVO_API_KEY olarak dışa aktarın veya dosyaya doğrudan anahtar yazın. JetBrains'in belirttiği üzere, “Herhangi bir $${...} referansı içermeyen değerler doğrudan kullanılır”.
2. Yukarıdaki JSON'u hesabınız için $JUNIE_HOME/models/kunavo.json dosyasına, depoyla paylaşmak içinse .junie/models/kunavo.json dosyasına kaydedin. .json uzantısı olmadan kullanılan dosya adı profil kimliği olur — aşağıdaki seçicinin custom:kunavo göstermesini sağlayan budur.
3. id değerini gerçekten kullanmak istediğiniz model kimliğine ayarlayın. Bu değer “API uç noktasının beklediği model tanımlayıcısı” olarak tanımlanır; dolayısıyla aşağıdaki tablodan bir Kunavo slug'ını doğrudan kullanabilirsiniz. Kimlikler Junie içinde değil, uç noktada çözümlenir.
4. Junie'yi başlatıp profili seçin: junie --model custom:kunavo veya etkileşimli oturumda /model komutu. Özel modeller “yerleşik sağlayıcıların ardından model seçimi listesinde görünür”.
5. Selamlaşma yerine bir dosyayı düzenleyen görev verin. Junie, neredeyse yaptığı her işte araç çağırmaya dayanan bir ajan istemcisidir. Bu nedenle bir şeyi okuyup yazdığı ilk çalıştırma, tek bir yanıttan çok daha fazla bilgi verir.

Junie için JetBrains'in Custom LLMs 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 Junie CLI 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ış.

Kunavo'nun yanıt verdiği diğer iki apiType değeri

apiType, bir satıcıyı değil istek biçimini belirtir ve Junie dört değer kabul eder: OpenAICompletion, OpenAIResponses, Google ve Anthropic. Kunavo üç rota sunar; dolayısıyla diğer üç değerden ikisinin burada karşılık gelen bir baseUrl rotası vardır. Junie yol eklemediğinden, biçimi değiştirmek URL'yi de aynı düzenlemede değiştirmek demektir:

1. "apiType": "OpenAICompletion" ve https://api.kunavo.com/v1/chat/completions ile — yukarıdaki profil. Bu sayfa, üç rota arasında en yaygın şekilde kullanılan rota olduğundan bunu önerir.
2. "apiType": "Anthropic" ve https://api.kunavo.com/v1/messages ile — Kunavo bu yolda Messages biçimine yanıt verir.
3. "apiType": "OpenAIResponses" ve https://api.kunavo.com/v1/responses ile.

Belirli bir model için üç Junie sürücüsünden hangisinin en iyi olduğunu ancak çalışma zamanı testi yanıtlayabilir; belgeleri okumak bunu göstermez. Bu nedenle bu sayfa ilk satırın ötesinde bir sıralama yapmıyor. Birini seçin; URL ile apiType değerini uyumlu tutun. Anahtarın ayarlandığı bir profilden 401 alırsanız Junie'nin başlık biçimini tahmin etmek yerine kimlik bilgisini açıkça belirtin: JetBrains, apiKey hakkında yalnızca olumsuz durumu belgeliyor — “Atlanırsa istekler Authorization başlığı olmadan gönderilir” — ve mevcut olduğunda kullanılan şemayı hiç belirtmiyor. extraHeaders, “her isteğe eklenecek ek HTTP başlıkları” olarak belgelenmiştir ve aynı $${VAR} referanslarını kabul eder; bu da "extraHeaders": {"Authorization": "Bearer $${KUNAVO_API_KEY}"} seçeneğini belirsizliği ortadan kaldıran biçim yapar.