LibreChat

LibreChat, bir ağ geçidini librechat.yaml içinde endpoints.custom bloğu olarak alır — dört zorunlu alan, .env'den anahtar ve seçicide görünmeden önce yeniden başlatma.

# librechat.yaml — project root, beside your .env
version: 1.3.5          # the value the documentation's own example carries

endpoints:
  custom:
    # Required: name, apiKey, baseURL, models. The name must be unique and
    # must not reuse a built-in endpoint name such as openAI or anthropic.
    - name: "Kunavo"
      apiKey: "${KUNAVO_API_KEY}"        # resolved from .env, not written here
      # Keep the /v1. LibreChat appends /chat/completions to this by default.
      baseURL: "https://api.kunavo.com/v1"
      models:
        default: ["claude-sonnet-5", "claude-haiku-4-5"]
        fetch: true                      # fills the picker from GET /v1/models
      titleConvo: true
      titleModel: "claude-haiku-4-5"         # titles are a separate call — pin a cheap id
      modelDisplayLabel: "Kunavo"

      # Optional but worth the four lines: without it LibreChat prices your
      # traffic from a table it ships. prompt/completion are USD per million
      # tokens; context is that model's own window. All three required.
      tokenConfig:
        claude-sonnet-5:
          prompt: 1.4
          completion: 7
          context: 1000000
        claude-haiku-4-5:
          prompt: 0.7
          completion: 3.5
          context: 200000

Adım adım

1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
2. Docker'da önce yapılandırmayı bağlayın: hızlı başlangıç kılavuzu docker-compose.override.yml.example dosyasını docker-compose.override.yml konumuna kopyalamanızı ve librechat.yaml birimini yorumdan çıkarmanızı ister. Doğrudan makineye kurulumda bu adım gerekmez.
3. Proje kökünde, .env dosyanızla aynı dizinde librechat.yaml oluşturun veya düzenleyin ve yukarıdaki endpoints.custom girdisini ekleyin.
4. Anahtarı .env içine KUNAVO_API_KEY=sk-kn-... olarak koyun. YAML'deki ${KUNAVO_API_KEY} yer tutucusu buradan çözülür; böylece gizli bilgi, depoya gönderdiğiniz yapılandırma dosyasına yazılmaz.
5. LibreChat'i yeniden başlatın, ardından uç nokta seçicisini açın: Kunavo, yerleşik olanların yanında ayrı bir girdi olarak görünür. Model listesi ya GET /v1/models üzerinden alınır ya da bu istek başarısız olursa models.default dizinizden kullanılır.
6. Bir mesaj gönderin, ardından model seçicisinin modelleri gerçekten değiştirdiğini kontrol edin. Kimlikler uç noktada çözümlenir; bu nedenle tek bir girdide Claude ve GPT kimliklerinin bulunması normaldir, yanlış yapılandırma değildir.

LibreChat'in özel uç nokta nesnesi başvurusu 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 LibreChat 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ış.

Ağ geçidi arkasında farklı davranan üç isteğe bağlı alan

Bu tablodaki her bilgi, yukarıda belirtilen tarihte incelenen aynı alan başvuru kaynağından alınmıştır. Bu, LibreChat'in kendi yapılandırmasına ilişkin açıklamasıdır; Kunavo test sonucu değildir ve isteğin istemciden çıktıktan sonra belirli bir model kimliğinin nasıl davranacağına ilişkin bir iddia değildir.

Bağlama, yapılandırma, ortam değişkenini ayarlama ve yeniden başlatma adımlarını içeren dört aşamalı kılavuz LibreChat'in özel uç noktalar için hızlı başlangıç sayfasında yer alır; bu sayfada örnek olarak bir ağ geçidi kullanılır.