Khoj ikinci beyninizi özel bir OpenAI base URL'de çalıştırın.

Hızlı yanıt: ilk çalıştırmada ortam değişkeni, her zaman yönetim paneli.

Khoj'un self-hosting compose dosyası, kendi ifadesiyle diğer OpenAI API uyumlu sağlayıcılar için tasarlanmış, yorum satırına alınmış bir OPENAI_BASE_URL satırı taşır. İlk başlatmadan önce bunu https://api.apisrouter.com/v1 olarak ayarlayın ve OPENAI_API_KEY'i bir gateway anahtarı tutacak şekilde belirleyin; Khoj'un başlatma süreci alışılmadık derecede yardımcı bir şey yapar: endpoint'in model listesini sorgular ve chat-model tablosunu endpoint'in sunduğu her id ile tohumlar, böylece katalog manuel giriş yapmadan Khoj'un model seçicisinde görünür. Zaten başlatılmış bir sunucuda, bunun yerine yönetim panelini kullanın. Gateway'e işaret eden bir AI Model API girdisi oluşturun (alanlar: Name, Api Key, Api Base Url), ardından Name'i tam model id'si olan, Model Type'ı Openai olarak ayarlanmış ve o AI Model API'ye bağlanmış Chat Model girdileri oluşturun. Her iki yüzey de docs.khoj.dev adresindeki Khoj'un OpenAI-proxy kılavuzunda belgelenmiştir.

services:
  server:
    environment:
      - OPENAI_BASE_URL=https://api.apisrouter.com/v1
      - OPENAI_API_KEY=sk-YOUR-APISROUTER-KEY

Khoj chat modeliyle ne yapar.

Khoj (GitHub'da khoj-ai, kabaca 36K yıldız), self-hostable bir AI ikinci beyindir: notlarınızı ve belgelerinizi (markdown, org-mode, PDF'ler ve daha fazlası) indeksler, ardından bunlar üzerinde sohbet etmenizi, kendi persona ve araçlarına sahip özel agent'lar çalıştırmanızı, bir cron üzerinde tetiklenen otomasyonlar zamanlamanızı ve çok adımlı araştırma çalıştırmaları başlatmanızı sağlar. Barındırılan bir uygulama vardır, ama özel endpoint'lerin uygulandığı yer self-hosted sunucudur ve bu sayfanın anlattığı dağıtım da budur. Bu özelliklerin her biri seçtiğiniz chat modeli üzerinden akar. Belge sohbeti, alınan not parçalarını prompt'a paketler, agent'lar tool call'lar ve persona talimatları ekler, otomasyonlar aynı pipeline'ı gözetimsiz çalıştırır ve araştırma modu soru başına birçok model çağrısını zincirler. Model Type Openai, Khoj'a bağlı AI Model API girdisinin Api Base Url'ine /v1/chat/completions konuşmasını söyler ve model Name'ini düz bir string olarak iletir; bu yüzden endpoint onu sunduğu sürece bir Claude veya DeepSeek id'si orada çalışır. Arama embedding'leri farklı bir alt sistemdir. Khoj, belgelerinizi varsayılan olarak yerel bir sentence-transformers modeliyle embed eder, bu yüzden chat endpoint'iyle ne yaparsanız yapın indeksleme ve semantik arama çalışmaya devam eder. Chat'i bir gateway üzerinden yönlendirmek yalnızca akıl yürütme faturasını taşır.

Tam kurulum: yönetim paneli girdileri adım adım.

Çalışan bir sunucuda, entegrasyonun tamamı üç yönetim ekranıdır. İlk olarak, AI Model API'yi ekleyin: /server/admin/database/aimodelapi/add adresini açın, adlandırın, gateway anahtarını Api Key'e yapıştırın ve Api Base Url'i https://api.apisrouter.com/v1 olarak ayarlayın. İkinci olarak, chat modelleri ekleyin: /server/admin/database/chatmodel/add adresinde, Name'i tam bir katalog id'sine ayarlayın (claude-sonnet-4-6, deepseek-v4-flash), Model Type'ı Openai olarak ayarlayın, az önce oluşturduğunuz Ai Model Api girdisini bağlayın ve Max prompt size'ı modelin bağlam penceresine uyan bir değere ayarlayın. Belgeler, OpenAI tipi modeller için Tokenizer'ı boş bırakmanızı önerir. Seçicide istediğiniz her model için tekrarlayın. Üçüncü olarak, modeli seçin: /settings üzerinde, yeni chat modelinizi varsayılan olarak seçin. Agent'lar modeli agent başına geçersiz kılabilir; bir Khoj örneğinin günlük otomasyonlar için hızlı bir id ve araştırma için sınır bir id çalıştırmasının yolu da budur.

1) /server/admin/database/aimodelapi/add
   Name:         APIsRouter
   Api Key:      sk-YOUR-APISROUTER-KEY
   Api Base Url: https://api.apisrouter.com/v1

2) /server/admin/database/chatmodel/add
   Name:         claude-sonnet-4-6   (exact catalog id)
   Model Type:   Openai
   Ai Model Api: APIsRouter
   Max prompt size: 100000

3) /settings -> select the new chat model

İkinci bir beyin için model seçmek.

Chat modelleri tek bir AI Model API'ye karşı eklediğiniz satırlar olduğundan, seçicide iki veya üç id tutmanın bedeli yoktur. Pratik kurulum, hızlı bir varsayılan artı bir sınır eskalasyonudur; ikisi de aynı anahtar üzerinden faturalandırılır, bu yüzden kullanım günlüğü her katmanın notlarınızda gerçekte neye mal olduğunu gösterir.

• Belge sohbeti girdi ağırlıklıdır: alınan not parçaları yanıtı gölgede bırakır. Girdi-token başına fiyat, soru başına maliyeti belirler; bu da günlük hatırlama için claude-haiku-4-5-20251001, deepseek-v4-flash veya gemini-3.5-flash'i avantajlı kılar.
• Araştırma modu çağrıları çoğaltır. Tek bir araştırma sorusu birçok model turunu zincirleyebilir, bu yüzden orada atadığınız id, faturayı başka herhangi bir ayardan daha fazla hareket ettirir; claude-sonnet-4-6 dengeli seçimdir, gpt-5.4 ise eskalasyondur.
• Zamanlanmış otomasyonlar gözetimsiz çalışır. Bunları bir abonelik gibi fiyatlandırın: günlük çağrı sayısı çarpı çağrı başına token sayısı, ki bu tam olarak anahtar başına kullanım günlüğünün raporladığı şeydir.
• Kişisel bilgi çelişki bakımından zengindir (planlar değişir, notlar eskir) ve modeller, çelişen notları harmanlamak yerine işaretlemede ne kadar iyi olduklarına göre farklılık gösterir; taahhüt etmeden önce aynı soru kümesinde iki id'yi test edin.
• Max prompt size Khoj'da chat modeli başınadır, bu yüzden uzun bağlamlı bir id yalnızca bu alanı buna uyacak şekilde yükseltirseniz karşılığını verir.

Kullandıkça öde · resmi fiyatların altında

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Khoj'a özgü hata modları.

Ortam değişkeni bir ilk-çalıştırma tohumudur, canlı bir ayar değildir. OPENAI_BASE_URL, sağlayıcı girdisini oluşturmak ve modelleri keşfetmek için başlatma sırasında okunur; zaten başlatılmış bir sunucuda, compose dosyasını düzenlemek görebileceğiniz hiçbir şeyi değiştirmez. İlk açılıştan sonraki değişiklikler için yönetim panelini kullanın veya gerçekten yeni bir tohum istiyorsanız veritabanını sıfırlayın. Placeholder-anahtar tuzağı: OPENAI_BASE_URL, OPENAI_API_KEY olmadan ayarlandığında, Khoj Ollama gibi yerel sunucuların çalışması için anahtarı bir placeholder ile doldurur. Bir gateway gerçek bir anahtar gerektirir, bu yüzden ilk-çalıştırma tohumlaması bir anahtar olmadan gerçekleştiyse, anahtarı yönetim panelindeki AI Model API girdisine yapıştırana kadar sohbetler kimlik doğrulama hatalarıyla başarısız olur. Otomatik keşif her şeyi tohumlar. Başlatma, endpoint'in sunduğu her modeli listelediğinden, çok satıcılı bir gateway uzun bir model tablosu tohumlayabilir. Zararsızdır, ama seçicinin kullanılabilir kalması için yönetim panelinde budamaya değer. Chat modeli Name'i tam olmalıdır. Khoj onu olduğu gibi iletir; bir yazım hatası ilk mesajda model-not-found olarak ortaya çıkar ve gateway'in /v1/models çıktısı yetkili yazımdır. Notlarınız üzerindeki semantik arama yanlış davranıyorsa, bu chat endpoint'iyle ilgisi olmayan yerel embedding alt sistemidir.

Khoj'u bir gateway üzerinden kim yönlendirir.

• Notları üzerinde model ailesi başına bir satıcı hesabı olmadan sınır-model sohbeti isteyen self-hoster'lar; tek bir anahtar Claude, GPT, DeepSeek ve Gemini id'lerini kapsar.
• Hızlı bir id'nin tekrarlayan maliyeti sabit tuttuğu ve kullanım günlüğünün bunu görünür kıldığı, günlük zamanlanmış otomasyonlar çalıştıran kullanıcılar.
• İndeksleme ve embedding'leri yerel tutan ve yalnızca chat prompt'larını denetlenebilir tek bir endpoint'e açan gizlilik odaklı kurulumlar.
• Aynı kişisel corpus üzerinde chat modellerini karşılaştıran meraklılar: her aday, aynı AI Model API'ye karşı bir chat-model satırıdır.
• Belirli bir satıcının faturalandırmasına erişimi olmayan geliştiriciler. Kart gerektirmeyen yükleme tabanlı erişim, sağlayıcı başına kayıt bağımlılığını ortadan kaldırır.

Endpoint'i doğrulayın ve ilk sohbeti hata ayıklayın.

Önce gateway'i kontrol edin: anahtarınızla modelleri listeleyin ve kaydetmeyi planladığınız id'leri doğrulayın. Khoj'un kendi otomatik keşfi, ilk-çalıştırma tohumlaması sırasında aynı çağrıyı yapar, bu yüzden bu curl çalışıyorsa, tohumlama da çalışacaktır. Hatalar temiz bir şekilde yerelleştirilir. Kimlik doğrulama hataları, AI Model API girdisindeki Api Key'in yanlış olduğu veya hâlâ tohumlanmış placeholder olduğu anlamına gelir. Model-not-found, bir chat modeli Name'inin katalog yazımıyla eşleşmediği anlamına gelir. Yanıt ortasında kesilen yanıtlar genellikle Max prompt size'ın veya modelin çıktı tavanının konuşma için çok düşük ayarlandığı anlamına gelir. İndeksleme ve arama sorunları yerel embedding pipeline'ıdır ve endpoint ile hiçbir ilgisi yoktur. Sohbetler akmaya başladığında, APIsRouter konsolu istek başına modeli, token sayılarını ve harcamayı gösterir. Otomasyonlar ve araştırma çalıştırmaları, ikinci-beyin maliyetlerinin saklandığı yerlerdir ve anahtar başına kullanım, bunları aylık bir sürpriz olarak değil özellik başına görmenizin yoludur.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

Sık sorulan sorular