Dokümantasyon

Copilot for Obsidian

Copilot'un BYOK sekmesi, üç alanla özel bir OpenAI uyumlu sağlayıcı eklemenizi sağlar. Elde edilen modellerin hangi arayüzlerde kullanılabildiği, belgelerin açıkça belirttiği konudur; bu sayfa da eklentinin tamamı için bir vaat sunmak yerine bu açıklığı korur.

Settings → Copilot → BYOK → Add a custom provider: Display name, anahtarınız ve https://api.kunavo.com/v1 — Quick Chat her zaman, Agent Chat ise sağlayıcı orada gösterildiğinde opencode altında kullanılabilir.

Ayarlar → Copilot → BYOK → Sağlayıcı ekle → Özel sağlayıcı ekle

Display name             Kunavo
API key                  sk-kn-...
Base URL                 https://api.kunavo.com/v1
Enable CORS              off — see the note below before turning it on
Model ID → Add           claude-sonnet-5
                         claude-haiku-4-5
Search available models  discovery reads GET /v1/models; typed ids also work
Save                     needs at least one model and a routable endpoint

Temel URL'nin sonundaki /v1 burada korunur; belgeler bunu bir cümleyle değil, örneklerle netleştirir: yalnızca "Özel bir OpenAI uyumlu sağlayıcının Base URL değeri olmalıdır" der; ancak sunduğu OpenAI uyumlu şablonların ikisinde de varsayılan URL /v1 ile biter: Ollama için http://localhost:11434/v1, LM Studio için http://localhost:1234/v1. Ayrıca "Model keşfi, uç noktanın /v1/models yanıtını kullanır" ifadesi yer alır. Keşif boş sonuç verirse, yeniden kontrol edilecek ilk şey bu ikilidir.

BYOK sağlayıcısı eklentinin her bölümünde kullanılamaz; belgeler bunu açıkça belirtir: "Anahtar eklemek, Claude Code veya Codex tarafından sağlanan modelleri değiştirmez." Kendi tablosunda BYOK modellerini doğrudan Quick Chat'e, Agent Chat'e ise yalnızca opencode arka ucunda, "sağlayıcı orada gösterildiğinde" sunar. Bu bir koşuldur, genel bir kural değildir. Ayrıca "opencode'un yönlendiremediği bir model opencode listesinden çıkarılır, ancak Quick Chat'te yine de çalışabilir." ifadesi yer alır. Claude veya Codex arka ucunu kullanıyorsanız bunun için ilgili CLI'ın kendi ortamını yapılandırın; bkz. /docs/integrations/claude-code.

CORS'u etkinleştir seçeneğini açmak bir ödünleşimdir; sürekli açık bırakılacak bir düzeltme değildir. Belgelerde şöyle denir: "Test başarılı olur ancak Quick Chat ileti gönderemezse sağlayıcıyı düzenleyip Enable CORS'u açın. Yanıtlar, belirteç belirteç akış halinde değil, işlem tamamlandıktan sonra görünür." Ayrıca bu anahtarın opencode yönlendirmesini değiştirmediği de belirtilir. Dolayısıyla Quick Chat'i düzeltmek için açarsanız, belirteç belirteç çıktı özelliğini orada kaybedersiniz; başka hiçbir yerde kaybetmezsiniz.

Copilot 4.x bir gömme sağlayıcısı istemez: anlamsal arama Miyo adlı ayrı bir hizmete taşınmıştır ve BYOK iletişim kutusunda bu tür bir alan yoktur. Bu yerindedir; çünkü Kunavo hiçbir gömme modeli sunmaz ve bu sayfa da böyle bir model sunduğunu ima etmeyecektir.

Kunavo bu eklentiyi çalışma zamanında test etmemiştir. Yukarıdaki her alan ve alıntı, aşağıda belirtilen tarihte doğrudan Copilot'un kendi belgelerinden alınmıştır; yayımlanmış bir kurulum sayfası, test çalıştırması değildir. Bir iş akışını bu eklentiye taşımadan önce Quick Chat üzerinden gerçek bir görev gönderin.

Henüz anahtarınız yok mu? Bir Kunavo hesabı oluşturun, bir anahtar oluşturun ( sk-kn- ile başlar) ve $10'dan kredi ekleyin — çağrılar bu bakiyeden ödenir ve başarısız çağrılar ücretlendirilmez. Ardından kontrol paneli Copilot for Obsidian kurulumunda açılır.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
Obsidian'da Ayarlar → Copilot → BYOK bölümünü açın ve Add a provider düğmesine tıklayın.
Adlandırılmış bir sağlayıcı veya Self Host şablonu yerine Add a custom provider seçeneğini seçin.
Display name, API key ve Base URL alanlarını yukarıda belirtildiği gibi doldurun. Şimdilik Enable CORS seçeneğini kapalı bırakın.
En az bir model ekleyin: ya Model ID → Add altında bir kimlik girin ya da GET /v1/models üzerinden doldurulan Search available models listesinden seçim yapın. Test'e, ardından Save'e tıklayın; model ve yönlendirilebilir bir uç nokta eklenmeden kayıt yapılamaz.
Bu modellerin nerede görüneceğini Basic → Agents → Quick Chat ve Basic → Agents → opencode bölümlerinde, her biri için ayrı bir Default model ayarlayarak seçin. Yeni sohbet modelleri varsayılan olarak her iki bölümde de etkinleştirilir.

Copilot'un Model Kaynakları ve BYOK 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.

Kısa sürüm budur. Model seçimi, gerçek bir oturumun maliyeti ve hata durumlarını içeren tam rehber belirteçler için hangi Copilot arka ucunun gerçekten ödeme yaptığı içindedir.

İ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 Copilot for Obsidian 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ış.

Model kimliği	Kunavo giriş / çıkış	Copilot for Obsidian içinde kullanım alanı
`claude-haiku-4-5`	$0.70 / $3.50	bir not hakkında gün boyunca sorulan kısa soruların yanıtlandığı Quick Chat
`claude-sonnet-5`	$1.40 / $7.00	Agent Chat'teki opencode arka ucu — varsayılan çalışma modeli
`claude-opus-5`	$3.50 / $17.50	yanlış yorumlamanın maliyetli olduğu, birçok not arasında uzun sentez çalışmaları
`gpt-5-6-sol`	$2.00 / $12.00	aynı anahtar ve aynı sağlayıcı satırını kullanan, başka bir model ailesinden ikinci görüş

Faturalandırma aylık ücret olmadan, ön ödemeli bakiyeden token başına yapılır — faturalandırmaya bakın. Tekrarlanan bağlamda — bir düzenleyicinin veya sohbet istemcisinin gönderdiği içeriğin çoğu budur — istem önbellekleme, faturayı model seçiminden daha fazla değiştirir.

Sık sorulan sorular

Obsidian Copilot'ta API anahtarını nereye girmeliyim?

Ayarlar → Copilot → BYOK → Add a provider yolunu izleyin; yerleşik listede olmayan bir uç nokta için ardından "Add a custom provider" seçeneğini seçin. İletişim kutusunda Display name, API key, Base URL ve isteğe bağlı Enable CORS anahtarı alanları bulunur. Ayrıca keşfedilen listeden seçerek veya kimliğini girerek en az bir model ekleyin ve ardından Save'e tıklayın. Copilot belgelerine göre sağlayıcı anahtarları kasanın data.json dosyasında değil, ilgili cihazın Obsidian Keychain'inde saklanır; dolayısıyla kasayı eşitlemek kimlik bilgisini başka bir bilgisayara taşımaz.

Obsidian Copilot temel URL'sinin sonunda /v1 olmalı mı?

/v1 biçimini kullanın; Kunavo için https://api.kunavo.com/v1. Belgeler bu kuralı tek bir cümleyle belirtmez; özel bir OpenAI uyumlu sağlayıcının Base URL gerektirdiğini, model keşfinin uç noktanın /v1/models yanıtını kullandığını ve sunduğu OpenAI uyumlu iki şablonun varsayılan olarak http://localhost:11434/v1 ve http://localhost:1234/v1 değerlerini kullandığını söyler. Her iki yerleşik varsayılan da bu son eki içerir; belgelerin bu konuda sunduğu en güçlü dayanak budur. Hatalı temel URL çoğunlukla kimlik doğrulama hatası yerine boş bir model listesine veya başarısız bir Test işlemine yol açar.

Obsidian Copilot, sağlayıcı anahtarı yerine OpenRouter veya Kunavo gibi bir ağ geçidi kullanabilir mi?

Quick Chat için evet; Agent Chat içinse belirli koşullarla. Copilot'un kendi belgelerinde BYOK, "doğrudan bir AI sağlayıcısına, uyumlu bir ağ geçidine veya bilgisayarınızdaki bir model sunucusuna" bağlanma yöntemi olarak açıklanır ve "Add a custom provider" seçeneği, OpenAI uyumlu herhangi bir temel URL'yi ve model kimliğini kabul eder. Model kaynakları tablosu, BYOK modellerini doğrudan Quick Chat'e; Agent Chat'e ise yalnızca opencode arka ucunda, "sağlayıcı orada gösterildiğinde" sunar. Claude ve Codex arka uçları hiçbir zaman BYOK anahtarı kullanmaz; belgelerde anahtar eklemenin bu arka uçların sağladığı modelleri değiştirmediği belirtilir.

Obsidian Copilot'un kasa araması için bir gömme modeline ihtiyacım var mı?

Sohbet sağlayıcınızdan almanız gerekmez. Copilot 4.x artık kendi eklentisi içinde bir dizin oluşturmaz: belgelere göre anlamsal arama ve Relevant Notes, yerel veya uzak ayrı bir hizmet olan Miyo tarafından sağlanır ve BYOK iletişim kutusunda bu tür bir model için alan bulunmaz. Kunavo da gömme modeli sunmaz; dolayısıyla burada böyle bir model sağlandığı ima edilmemelidir. Copilot'taki sohbet sağlayıcısı satırı yalnızca sohbetin ücretini karşılar.

Kunavo anahtarı, Copilot Lite veya Plus lisansının yerini alır mı?

Hayır; bu ikisi özellikle ayrı tutulur. Copilot belgeleri lisansı ve BYOK'u farklı model kaynakları olarak ele alır: lisans, Brevilabs'ın planınıza göre ücretlendirdiği Copilot tarafından barındırılan modelleri sağlar; BYOK ise istekleri kendi uç noktanıza gönderir ve ücretlendirme o sağlayıcıda kalır. Buradaki bir anahtar lisans kotasını yenilemez, Copilot tarafından barındırılan kilitli satırların kilidini açmaz ve lisansa bağlı hizmetleri değiştirmez. Buna karşılık BYOK'u hiçbir lisans olmadan ücretsiz planda çalıştırabilirsiniz.