LibreChat

LibreChat menerima gateway sebagai blok endpoints.custom di librechat.yaml — empat field wajib, key dari .env, dan restart sebelum pemilih menampilkannya.

# 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

Langkah demi langkah

1. Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
2. Untuk Docker, pasang konfigurasi terlebih dahulu: panduan mulai cepat meminta Anda menyalin docker-compose.override.yml.example ke docker-compose.override.yml dan menghapus komentar pada volume librechat.yaml. Instalasi langsung tanpa Docker tidak memerlukan langkah ini.
3. Buat atau edit librechat.yaml di direktori root proyek — direktori yang sama dengan .env — lalu tambahkan entri endpoints.custom di atas.
4. Simpan kunci di .env sebagai KUNAVO_API_KEY=sk-kn-.... Placeholder ${KUNAVO_API_KEY} dalam YAML akan diisi dari sana, sehingga rahasia tidak tersimpan dalam berkas konfigurasi yang Anda commit.
5. Mulai ulang LibreChat, lalu buka pemilih endpoint: Kunavo akan muncul sebagai entri tersendiri di samping entri bawaan. Daftar model diambil dari GET /v1/models atau, jika pengambilan gagal, menggunakan array models.default Anda.
6. Kirim satu pesan, lalu pastikan pemilih model benar-benar beralih model — ID diselesaikan di endpoint, jadi ID Claude dan GPT dalam satu entri adalah hal yang wajar di sini, bukan kesalahan konfigurasi.

Diperiksa terhadap Referensi objek endpoint khusus LibreChat pada 21 September 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di LibreChat.

# 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-..."

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

Tiga kolom opsional dengan perilaku berbeda di balik gateway

Semua informasi dalam tabel ini berasal dari referensi kolom yang sama, dibaca pada tanggal di atas. Ini adalah penjelasan LibreChat tentang konfigurasinya sendiri — bukan hasil pengujian Kunavo dan bukan klaim tentang perilaku ID model tertentu setelah permintaan meninggalkan klien.

Panduan empat langkah — pasang, konfigurasi, tetapkan variabel lingkungan, lalu mulai ulang — tersedia di halaman mulai cepat LibreChat untuk endpoint khusus, yang menggunakan gateway sebagai contoh.