Dokumentasi

LobeChat

Instalasi LobeChat yang dihosting sendiri memerlukan tiga variabel lingkungan agar dapat terhubung ke Kunavo: kunci, URL proksi, dan daftar ID model yang ingin ditampilkan di pemilih.

Atur OPENAI_API_KEY ke kunci sk-kn-… Anda, OPENAI_PROXY_URL ke https://api.kunavo.com/v1, dan cantumkan ID yang Anda inginkan di OPENAI_MODEL_LIST. Claude dan GPT kemudian menggunakan satu pemilih dan satu saldo.

.env

OPENAI_API_KEY=sk-kn-...
OPENAI_PROXY_URL=https://api.kunavo.com/v1

# LobeChat only shows models it knows about, so name the ones you want.
OPENAI_MODEL_LIST=claude-sonnet-5,claude-haiku-4-5,claude-opus-5,gpt-5-6-terra

Akhiran /v1 harus disertakan dalam OPENAI_PROXY_URL. LobeChat meneruskan permintaan ke URL yang Anda berikan, alih-alih menyusun ulang jalur OpenAI. Karena itulah, referensi .env.example milik LobeChat sendiri mencantumkan nilai default sebagai https://api.openai.com/v1 — termasuk akhirannya.

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Tambahkan ketiga variabel ke lingkungan deployment Anda — ke berkas .env untuk instalasi langsung, atau ke blok environment untuk Docker.
Mulai ulang kontainer agar lingkungan baru terbaca.
Buka LobeChat, mulai sesi, lalu pilih salah satu ID yang Anda cantumkan di OPENAI_MODEL_LIST.

docker-compose.yml

services:
  lobe-chat:
    image: lobehub/lobe-chat
    ports:
      - "3210:3210"
    environment:
      OPENAI_API_KEY: sk-kn-...
      OPENAI_PROXY_URL: https://api.kunavo.com/v1
      OPENAI_MODEL_LIST: claude-sonnet-5,claude-haiku-4-5,gpt-5-6-terra

Referensi LobeChat sendiri untuk variabel-variabel ini adalah halaman variabel lingkungan penyedia model.

Verifikasi sebelum menelusuri masalah kontainer

Satu permintaan akan memastikan apakah masalahnya ada pada endpoint, kunci, atau daftar model LobeChat. Jika permintaan ini mengembalikan daftar ID model dalam JSON, URL dan kunci yang sama berfungsi — dan jika pemilih tetap kosong setelah itu, masalahnya ada pada OPENAI_MODEL_LIST, bukan pada endpoint.

# Settles whether a failure is the endpoint, the key, or LobeChat.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

ID yang perlu dicantumkan

Semua model teks di Kunavo dapat dicantumkan di OPENAI_MODEL_LIST — daftar lengkapnya tersedia di halaman model dan diperoleh secara langsung dari GET /v1/models. Tarif dalam USD per 1M token, input / output.

ID model	Kunavo masuk / keluar	Kesesuaiannya
`claude-haiku-4-5`	$0.70 / $3.50	Claude termurah — untuk sesi chat panjang saat biaya per giliran menjadi pertimbangan
`claude-sonnet-5`	$1.40 / $7.00	Keseimbangan kualitas dan harga sebagai pilihan default
`claude-opus-5`	$3.50 / $17.50	Tingkat Claude dengan kualitas tertinggi
`gpt-5-6-terra`	$0.70 / $4.20	Kunci yang sama, keluarga berbeda — tidak perlu mengonfigurasi penyedia kedua

Klien chat mengirim ulang seluruh percakapan pada setiap giliran, sehingga pengeluaran token di LobeChat bertambah seiring panjang sesi, bukan tetap untuk setiap pesan — caching prompt adalah faktor yang paling berpengaruh pada pola tersebut. Penagihan dihitung per token dari saldo prabayar tanpa biaya bulanan, jadi bulan tanpa penggunaan tidak dikenai biaya; detailnya ada di penagihan.

Pertanyaan umum

Bagaimana cara mengarahkan LobeChat ke endpoint khusus yang kompatibel dengan OpenAI?

Atur OPENAI_PROXY_URL ke URL dasar endpoint dan OPENAI_API_KEY ke kunci Anda di lingkungan deployment — untuk Kunavo, nilainya adalah https://api.kunavo.com/v1. Berkas .env.example milik LobeChat sendiri menggunakan https://api.openai.com/v1 sebagai contoh nilai variabel tersebut. Ini mengingatkan bahwa akhiran /v1 harus disertakan dalam nilainya dan tidak ditambahkan untuk Anda.

Mengapa model kustom saya tidak muncul di daftar model LobeChat?

LobeChat menampilkan model yang telah diberitahukan kepadanya, bukan semua model yang dapat disediakan endpoint. Karena itu, ID model yang tidak ada dalam daftarnya tidak akan terlihat, meskipun endpoint merespons untuk ID tersebut. Cantumkan ID dalam OPENAI_MODEL_LIST sebagai daftar yang dipisahkan koma. Dokumentasi LobeChat juga menetapkan sintaks awalan untuk variabel tersebut: tanda + di awal menambahkan model, tanda - di awal menyembunyikan model, dan model_name=display_name mengganti nama model di pemilih.

Bisakah LobeChat menggunakan model Claude melalui penyedia OpenAI?

Bisa, jika model tersebut disediakan melalui endpoint yang kompatibel dengan OpenAI. Penyedia OpenAI di LobeChat mengirimkan ID model ke alamat yang ditentukan oleh OPENAI_PROXY_URL, sehingga ID Claude diresolusikan di gateway, bukan di dalam LobeChat, dan kredensial Anthropic tidak digunakan. Di Kunavo, ID Claude dan GPT berada di balik satu kunci, jadi untuk menambahkan satu keluarga model, cukup tambahkan ID ke OPENAI_MODEL_LIST.

Apakah pembuatan gambar LobeChat berfungsi melalui endpoint kustom?

Itu bergantung pada rute yang diterapkan endpoint, bukan pada LobeChat. Penyedia chat memerlukan /v1/chat/completions; pembuatan gambar menggunakan rute terpisah. Kunavo menerapkan pembuatan gambar dan video melalui endpoint tersendiri, yang didokumentasikan di bagian images dan video. Karena itu, pola yang andal adalah menggunakan LobeChat untuk chat dan memanggil endpoint media secara langsung, alih-alih menganggap satu pengaturan penyedia mencakup keduanya.