Dokümantasyon

Page Assist

Page Assist, yerel bir Ollama için geliştirildi; ancak aynı ekranda barındırılan bir uç nokta da eklenebiliyor: Settings → OpenAI Compatible API → Add Provider → Custom, üç alan. Ardından kenar çubuğunda, dizüstü bilgisayarınızın RAM’ine sığan model yerine Claude veya GPT ile o sırada açık olan seketin özeti gösteriliyor.

Settings → OpenAI Compatible API → Add Provider → Custom: Provider Name, /v1'i koruyan bir Base URL ve anahtar — ardından Page Assist'in kendisi getirdiği listeden model kimliklerini işaretleyin.

Ayarlar → OpenAI Compatible API → Sağlayıcı Ekle → Özel

Provider Name   Kunavo
Base URL        https://api.kunavo.com/v1
API Key         sk-kn-...
                [ Save ]

Model List      (appears after Save — fetched from GET /v1/models)
  [x] claude-haiku-4-5
  [x] claude-sonnet-5
  [x] gpt-5-6-terra

Base URL kendi /v1 son ekini taşır. OpenAI Compatible API sayfası bunu kendi başına belirtmiyor — alanın yardım metni belirtiyor. Yardım metninde “OpenAI API sağlayıcısının Base URL’si. ör. (http://localhost:1234/v1)” yazıyor. Aynı alan için somut URL veren iki kardeş sağlayıcı sayfası da bunu doğruluyor: LM Studio sayfasındaki “varsayılan olarak http://localhost:1234/v1 olur” ifadesi ve LLaMA.cpp sayfasındaki http://localhost:8080/v1. Page Assist yalnızca yolu ekler; bu nedenle yalın kaynak adresi 401 yerine 404 döndürür — Anthropic tarzı ve yalnızca kaynak adresini isteyen istemcilerin tam tersi.

Model List genellikle elle girilmez, uç noktadan getirilir. Save işleminden sonra Page Assist, “Bu sağlayıcıyla kullanmak istediğiniz sohbet modellerini seçin” mesajını gösteren bir Model List açar ve listeyi uç noktadan alınan verilerle doldurur. Kunavo GET /v1/models yanıtını verir; dolayısıyla liste kendiliğinden dolar. Liste boş gelirse uzantı “Model bulunamadı. Doğru sağlayıcıyı Base URL ve API anahtarıyla eklediğinizden emin olun” mesajını gösterir; bu doğru bir uyarıdır: boş listenin nedeni katalogdan çok Base URL veya anahtar sorunudur. Uzantıya geçmeden önce aşağıdaki curl ile kontrol edin. Kimlikler, Add Custom Model üzerinden elle de eklenebilir; buradaki Model ID alanına bu sayfadaki tablodan bir slug’ı olduğu gibi girebilirsiniz.

Diğer radyo seçeneğini değil, Chat Model’i seçin. Add Custom Model formunda Model Type seçeneği bulunur. Kunavo bir embedding modeli sunmadığından katalogda bu uç noktanın yanıt vereceği bir şey yoktur; dolayısıyla ikinci seçeneğin burada yönlendirileceği bir yer bulunmuyor. Knowledge Base özelliği buna bağlıdır: sağlayıcının kendi sayfası, RAG Settings bölümünde bir model ayarlamanız gerektiğini söylüyor ve nomic-embed-text öneriyor. Bu iş için bu sağlayıcının yanında yerel bir Ollama da yapılandırın — Page Assist aynı anda birçok sağlayıcıyı tutabilir ve bu iki rolün aynı yerden gelmesi gerekmez.

Ses ayarları ayrı bir konudur. Page Assist’in Text-to-Speech bölümü, kendine ait API Key, Base URL ve TTS Model alanları bulunan bir OpenAI TTS sağlayıcısı sunuyor; Kunavo ise text-to-speech modeli sunmuyor. Tersi de geçerli: Kunavo speech-to-text modeli sunmuyor ve Page Assist’in ses girişi herhangi bir API çağrısı değil; Speech Recognition Language altında yapılandırılan tarayıcının kendi tanıyıcısını kullanıyor. Her iki bölümü de mevcut hedeflerinde bırakın.

Bu yapılandırma, aşağıdaki tarihte sağlayıcının belgelerinden ve kendi arayüz metinlerinden derlenmiştir. Kunavo, Page Assist’i kendi uç noktasına karşı çalıştırmamıştır — sabitlenmiş bir uzantı sürümü, kenar çubuğu oturumu, akış halinde yanıt veya araç gidiş dönüşü yoktur. Yayımlanmış bir kurulum sayfası test değildir ve buradaki hiçbir şey test olarak yorumlanmamalıdır. On saniyede kendi başınıza doğrulayabileceğiniz şey curl; uzantının çalışan bir uç nokta üzerinde nasıl davrandığı ise sizinle Page Assist arasındadır.

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 Page Assist kurulumunda açılır.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
Tarayıcı araç çubuğundaki Page Assist simgesine, ardından Settings simgesine tıklayın ve OpenAI Compatible API sekmesine gidin.
Add Provider öğesine tıklayın. Kunavo açılır listedeki hazır ayarlardan biri olmadığından Custom seçeneğini belirleyin — sağlayıcının 5. adımda anlattığı yol, listesinde yer almayan her şey için budur.
Provider Name alanını, Base URL = https://api.kunavo.com/v1 değerini ve API Key alanını doldurun; ardından Save öğesine tıklayın.
Açılan Model List içinde istediğiniz kimlikleri işaretleyin. Genellikle iki model uygundur: sayfa özetleri için ucuz bir model ve devamındaki sorular için güçlü bir model.
Gerçek bir sayfada kenar çubuğunu açın — Ctrl+Shift+L Web UI’yi açar — seçiciden modeli seçip açık olan sekme hakkında soru sorun. Gerçek içerik barındıran bir sayfa, bir selamlaşmadan daha fazla bilgi verir; çünkü maliyet oluşturan kısım sayfa metnidir.

Page Assist’in OpenAI Compatible API 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 Page Assist 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ış	Page Assist içinde kullanım alanı
`claude-haiku-4-5`	$0.70 / $3.50	kenar çubuğu için varsayılan: hacmin belirleyici olduğu sayfa özetleri ve devam soruları
`gpt-5-6-terra`	$0.70 / $4.20	uzun sayfalar — belgeler, konu dizileri, dökümler — kısaltılmadan bütünüyle gönderilir
`claude-sonnet-5`	$1.40 / $7.00	özetten sonra gelen ve yanıtın doğru olması gereken soru
`gpt-5-6-sol`	$2.00 / $12.00	başka bir aileden ikinci bir görüş; aynı sağlayıcıda ikinci işaretlenmiş kimlik olarak ekleyin

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.

Sayfanın maliyeti ve tarayıcıdan çıkanlar

Kenar çubuğu istemcisinin ücretlendirmesi bir düzenleyicininkinden farklıdır; farkı yaratan sayfadır. Page Assist sekmeyle sohbet ederken her turda o sekmeden çıkarılan metin girdi belirteçleri olarak gönderilir — bir belge sayfası veya uzun bir konu dizisi on binlerce belirteç içerebilir ve aynı konuşmadaki her devam mesajıyla yeniden gönderilir. Model tablosunun başında ucuz kimliklerin yer almasının nedeni budur: bu istemcide girdi tarafı genellikle çıktı tarafından bir büyüklük mertebesi daha fazladır ve claude-haiku-4-5 ya da gpt-5-6-terra tüm bir sayfayı okuması, daha güçlü bir modelin kısaltılmış bir metni okumasından iyidir.

Sağlayıcının Settings sayfasında listelenen üç ayar, özellikle talep etmediğiniz ek trafiğe yol açar:

Generate Title using AI — “Konuşmadan otomatik olarak bir sohbet başlığı oluşturur”. Seçili model hangisi olursa olsun, konuşma başına bir ek çağrı yapılır.
Internet Search; Internet Search varsayılan olarak ON durumundadır ve Total Search Results ayarı bulunur — getirilen sayfalar isteme eklenir; dolayısıyla belirteç faturası sonuç sayısıyla birlikte artar.
Page Action adlı yardımcı uzantı: model “önce sayfayı okuyup ardından işlemleri adım adım gerçekleştirir”; bu, konuşma başına değil, her adımda DOM’un okunması demektir. Uzantının kendi Her işlemden önce onay iste ayarı varsayılan olarak açıktır ve açık bırakılması yerinde olur.

Gizlilik sınırı da aynı çizgiyi izler. Page Assist sohbetleri, bilgi tabanını ve ayarları tarayıcı depolama alanında yerel olarak saklar; ağ üzerinden yalnızca sizin gönderdikleriniz iletilir. Bu sağlayıcı seçildiğinde api.kunavo.com sayfa metni, mesajınız ve o ana kadarki konuşma demektir; bunlar buradan model kimliğini sunan üst kaynağa iletilir — bu uçta nelerin saklandığını öğrenmek için gizlilik politikasına bakın. Bir sohbet penceresine yapıştırmayacağınız bir sayfada yerel Ollama’ya geri dönün; uzantı her iki sağlayıcıyı da aynı anda yapılandırılmış tutar, böylece bu geçiş tek bir açılır listeden yapılabilir.

Buraya OpenRouter hazır ayarından geldiyseniz

OpenRouter için Custom seçeneğine gerek yoktur. Sağlayıcının OpenAI Compatible API sayfasında listelenen hazır ayarlardan biridir — Ollama, LM Studio, Groq, Together, Mistral, xAI ve yaklaşık yirmi başka sağlayıcının yanında yer alır. Bu nedenle ilk dört tıklama aynı kalır; ardından açılır listede Custom yerine OpenRouter seçilir, API Key alanına anahtarı girilir ve Save öğesine tıklanır. Hazır ayar kendi Base URL’sini içerir; OpenRouter model kimlikleri anthropic/claude-sonnet-4.5 biçiminde sağlayıcı öneki taşırken yukarıdaki tablodaki kimlikler yalındır. Burada sağlayıcı seçmek, hangi kimlik ad alanına giriş yapacağınızı seçmektir.

Özellikle bu istemcide geçiş şu durumlarda avantajlıdır: Kunavo’nun sunmadığı modellere de tek ekrandan erişmek istiyorsanız veya anahtarınızı zaten girdiyseniz ve ek kurulum maliyeti sıfırsa. Kunavo’ya geçiş şu durumlarda avantajlıdır: tablodaki kimlikleri kodlama araçlarında da kullanıyorsanız, böylece tek anahtar ikisini de kapsar; ayrıca kenar çubuğunun faturasını belirleyen, yeniden gönderilen sayfa bağlamında istem önbelleğe almadır — bkz. önbelleğe alma. Her iki sağlayıcıyı da tutabilirsiniz: Page Assist ikisini birlikte listeler ve model seçici modelin hangi satırdan geldiğini önemsemez.

Sık sorulan sorular

Page Assist ile özel bir API’yi nasıl kullanırım?

Tarayıcı araç çubuğundaki Page Assist simgesine tıklayın, Settings’i açın, OpenAI Compatible API sekmesine gidin ve Add Provider öğesine tıklayın. Uç noktanız açılır listedeki hazır ayarlardan biri değilse Custom’ı seçin, Provider Name, Base URL ve API Key alanlarını doldurup Save’e tıklayın. Page Assist daha sonra uç noktadan getirilen bir Model List açar; burada söz konusu sağlayıcıyla kullanmak istediğiniz sohbet modellerini işaretleyin. Getirme işlemi sonuç vermezse Add Custom Model üzerinden kimlikleri elle de girebilirsiniz.

Page Assist Base URL’sinin sonunda /v1 bulunması gerekir mi?

OpenAI uyumlu bir uç nokta için evet. OpenAI Compatible API sayfasında belirtilmiyor; ancak Base URL alanının kendi yardım metninde yazıyor: “OpenAI API sağlayıcısının Base URL’si. ör. (http://localhost:1234/v1)”. LM Studio ve LLaMA.cpp sayfalarında aynı alan için aynı son ek, http://localhost:1234/v1 ve http://localhost:8080/v1 olarak veriliyor. Bu nedenle Kunavo için adres https://api.kunavo.com/v1 olmalı. Page Assist yalnızca yolu ekler; son eki kaldırmak kimlik doğrulama hatası yerine 404’e yol açar.

Sağlayıcı ekledikten sonra Page Assist neden model göstermiyor?

Liste, az önce girdiğiniz anahtar kullanılarak uç noktadan getirilir. Uzantının kendi mesajı neyi kontrol etmeniz gerektiğini söylüyor: “Model bulunamadı. Doğru sağlayıcıyı Base URL ve API anahtarıyla eklediğinizden emin olun.” Aynı ikiliyi uzantının dışında /v1/models adresine curl isteği göndererek sınayın — JSON yanıtı, sorunun sağlayıcı kaydında olduğunu; 401, sorunun anahtarda olduğunu; 404 ise genellikle Base URL’de /v1 bulunmadığını gösterir. Bu da işe yaramazsa getirme işlemine bağlı olmayan Add Custom Model üzerinden kimlikleri elle ekleyin.

Page Assist, yerel model yerine Claude veya GPT kullanabilir mi?

Evet. “OpenAI Compatible API” ifadesi satıcıyı değil, kablolu iletişim biçimini adlandırır ve model kimliği yapılandırdığınız Base URL’ye iletilir; dolayısıyla Claude veya GPT kimliği uzantı içinde değil, bu uç noktada çözülür. Yerel model özellikleri etkilenmez: Page Assist aynı anda birkaç sağlayıcı tutabilir; böylece bir Ollama kaydıyla barındırılan bir kayıt yan yana bulunabilir ve model seçicisinden aralarında geçiş yapabilirsiniz.

Page Assist için en ucuz model hangisi?

Bu istemcide girdi tarafı belirleyicidir; çünkü bir sekmeyle sohbet ederken sekmeden çıkarılan metin konuşmadaki her turda yeniden gönderilir. Bu nedenle yüksek bağlam kapasitesine sahip ucuz bir model varsayılan olarak uygundur: sıradan sayfalar için claude-haiku-4-5, uzun sayfalar için gpt-5-6-terra. Yanıtın önemli olduğu sorular için claude-sonnet-5 gibi daha güçlü bir kimliği ikinci seçenek olarak işaretleyin. Her birinin milyon başına ücretleri bu sayfadaki tabloda yer alıyor. İstem önbelleğe alma, kenar çubuğunun faturasını model seçiminden daha fazla etkiler.

Page Assist’in Knowledge Base özelliği Kunavo’yu kullanabilir mi?

Dizin oluşturma kısmında kullanamaz. Knowledge Base bir RAG özelliğidir ve sağlayıcının belgelerine göre RAG Settings bölümünde bir embedding modeli ayarlamanız gerekir; belgeler nomic-embed-text modelini öneriyor. Kunavo embedding modeli sunmadığından bu alan için başka bir sağlayıcı gerekir. Genellikle yerel Ollama tercih edilir ve çakışma olmadan bunun yanında çalışır. Sohbet kısmı etkilenmez: belgeler dizine eklendikten sonra bunlarla ilgili soruları yanıtlayan model, bu sağlayıcıdaki herhangi bir sohbet kimliği olabilir.

Kunavo, Page Assist’i test etti mi?

Hayır. 21 Eylül 2026 tarihinde kontrol edilenler, Page Assist’in kendi OpenAI Compatible API belgeleri ve uzantının İngilizce arayüz metinleriydi — Settings içindeki yol, alan etiketleri ve sıraları, Base URL örneği ve boş liste mesajı bu kaynaklardan alıntılanmıştır. Kunavo uzantıyı yüklemedi, bir sürümü sabitlemedi ve üzerinden istek göndermedi; belirli bir sürümde akış, sayfa metninin çıkarılması veya Model List getirme işleminin davranışı hakkında herhangi bir iddiada bulunmuyor. Bu sayfadaki curl, bağımsız olarak doğrulayabileceğiniz kısımdır.