Jalankan LobeChat di endpoint OpenAI-compatible kustom.
Updated 2026-07-29
Modul provider LobeChat menerima layanan OpenAI-compatible apa pun: buat provider kustom dengan tipe SDK OpenAI, atur endpoint ke https://api.apisrouter.com/v1, tempel satu key, dan ambil daftar model. Id Claude, GPT, Gemini, dan DeepSeek mendarat di picker model setiap asisten.
Jawaban singkat: satu provider kustom, satu endpoint, satu key.
Buka pengaturan LobeChat dan masuk ke bagian AI service provider (berlabel AI Service Provider atau Language Model tergantung rilis). Karena modul manajemen-provider hadir di v1.44, Anda bisa membuat provider kustom alih-alih menumpang pada entri OpenAI bawaan: tambahkan provider, beri id dan display name (apisrouter / APIsRouter), pilih tipe SDK OpenAI, lalu isi API key dan endpoint proxy URL dengan https://api.apisrouter.com/v1. Di daftar model provider, gunakan aksi fetch-models untuk menarik setiap id yang dilayani endpoint melalui /v1/models, aktifkan yang Anda inginkan, dan jalankan pemeriksaan konektivitas bawaan. Sejak itu, asisten atau percakapan mana pun bisa memilih id itu dari picker model. Proyeknya sekarang berada di lobehub/lobehub di GitHub (nama repo lobe-chat mengarahkan ke situ), dan label menu bergeser antar rilis, jadi perlakukan alurnya, entri provider, tipe SDK, URL, key, fetch, sebagai bagian yang stabil daripada kata-kata persisnya.
Provider ID: apisrouter
Provider Name: APIsRouter
SDK Type: OpenAI
API Key: sk-YOUR-APISROUTER-KEY
API Proxy URL: https://api.apisrouter.com/v1
Model List → Fetch models → aktifkan id → cekBagaimana LobeChat merutekan request ke provider.
LobeChat (sekitar 80K bintang GitHub, sekarang di bawah nama LobeHub) adalah salah satu framework chat open-source paling banyak dideploy: client web yang rapi, asisten dengan prompt dan model mereka sendiri, sistem plugin, dan fitur knowledge-base, bisa dideploy dalam sesi browser atau self-hosted dengan database. Setiap entri provider menjelaskan ke mana request pergi dan dialek SDK mana yang harus dibicarakan. Provider kustom dengan tipe SDK OpenAI mengirim request chat-completions standar ke proxy URL Anda dengan id model sebagai string biasa, yang persis bentuk yang diharapkan gateway multi-vendor. Satu entri karenanya mengangkut seluruh katalog: asisten bisa mem-pin claude-sonnet-4-6 untuk kerja hati-hati sementara percakapan cepat berjalan di gemini-3.5-flash, tanpa akun kedua di mana pun. URL endpoint punya satu nuansa terdokumentasi yang layak dikutip: apakah URL butuh suffix /v1 tergantung layanan di baliknya. LobeChat menambahkan path route seperti /chat/completions ke base yang Anda berikan, jadi untuk APIsRouter nilai yang benar adalah https://api.apisrouter.com/v1. Gejala terdokumentasi dari suffix yang hilang adalah model mengembalikan balasan kosong pada tes; jika Anda melihat itu, tambahkan /v1 dan coba lagi.
Self-hosting: jalur environment variable.
Jika Anda mendeploy LobeChat sendiri, routing yang sama bisa dikirim di container alih-alih diklik ke UI. Pasangan klasiknya mengoverride provider OpenAI bawaan: OPENAI_API_KEY mengambil key gateway dan OPENAI_PROXY_URL mengambil https://api.apisrouter.com/v1. Setiap pengguna deployment itu kemudian mewarisi endpoint tanpa menyentuh pengaturan. Visibilitas model dikontrol dengan sintaks daftar-model: OPENAI_MODEL_LIST menerima +id untuk menambah, -id untuk menyembunyikan, dan id=Display Name untuk melabel ulang, dengan entri dipisahkan koma. Memulai nilainya dengan -all membersihkan daftar bawaan sehingga hanya id eksplisit Anda yang muncul, yang merupakan bentuk bersih untuk deployment yang dikurasi. Build server yang lebih baru juga mendokumentasikan keluarga CUSTOM_PROVIDER_* (count, id, name, type, base URL, key) untuk mendeklarasikan provider kustom lengkap saat deploy time, sesuai apa yang dilakukan modul UI-nya. Cek referensi environment-variable terkini untuk versi Anda sebelum mengandalkannya, karena permukaan ini lebih baru dari pasangan OPENAI_* dan masih berkembang.
OPENAI_API_KEY=sk-YOUR-APISROUTER-KEY
OPENAI_PROXY_URL=https://api.apisrouter.com/v1
OPENAI_MODEL_LIST=-all,+claude-sonnet-4-6=Claude Sonnet 4.6,+gpt-5.5,+gemini-3.5-flash,+deepseek-v4-proMemilih model untuk asisten.
Karena semua asisten ditagih melalui satu key, perbandingan model adalah perubahan pengaturan asisten. Pin dua kandidat pada dua asisten duplikat, jalankan prompt nyata Anda selama seminggu, dan baca pengeluaran per model di konsol APIsRouter di sebelah kualitas jawaban yang Anda amati.
- Asisten adalah pin model per role. Asisten penulisan pada claude-sonnet-4-6, asisten jawaban-cepat pada claude-haiku-4-5-20251001, dan asisten riset pada gpt-5.5 semuanya hidup berdampingan di balik satu entri provider.
- gemini-3.5-flash adalah pilihan responsivitas untuk model percakapan default; sebagian besar giliran dalam framework chat singkat dan cepat, dan model cepat menjaga UI terasa instan.
- deepseek-v4-pro mendapat slot untuk percakapan multibahasa panjang dan ringkasan berat, di mana perilaku long-context per token yang dihabiskan adalah daya tariknya.
- Percakapan visi butuh id yang mendukung visi dengan kapabilitas diaktifkan di konfigurasi model provider; LobeChat menampilkan toggle kapabilitas per model di modul provider.
- Aktifkan picker dua-tier secara sengaja, satu id cepat dan satu id frontier, dan tambahkan lagi hanya saat asisten nyata membutuhkannya; setiap model yang diaktifkan adalah baris yang di-scroll pengguna.
Bayar sesuai pemakaian · di bawah harga resmi
Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.
| Model | Harga Resmi | Harga Kami |
|---|---|---|
| Claude Sonnet 4.6 | $3.00 / $15.00 per M | $2.40 / $12.00 per M |
| GPT-5.5 | $5.00 / $30.00 per M | $4.00 / $24.00 per M |
| Gemini 3.5 Flash | $1.50 / $9.00 per M | $1.20 / $7.20 per M |
| DeepSeek V4 Pro | $0.43 / $0.87 per M | $0.40 / $0.90 per M |
| Claude Haiku 4.5 20251001 | $1.00 / $5.00 per M | $0.80 / $4.00 per M |
Mode kegagalan spesifik LobeChat.
Balasan kosong pada pemeriksaan konektivitas adalah tanda tangan terdokumentasi dari masalah suffix base-URL. Tambah atau hapus /v1 (untuk APIsRouter itu harus ada) dan coba lagi sebelum debug lebih dalam. Model yang hilang dari picker asisten biasanya berarti mereka sudah diambil tapi tidak diaktifkan di daftar model provider, atau toggle provider itu sendiri mati. Keduanya hidup di layar pengaturan yang sama dengan aksi fetch. Pada deployment self-hosted, ingat urutan prioritas: environment variable mengonfigurasi default sisi server, sementara pengguna masih bisa memasukkan pengaturan provider mereka sendiri sisi client tergantung auth dan feature flag deployment Anda. Jika deployment mengabaikan OPENAI_PROXY_URL Anda, konfirmasi container-nya benar-benar restart dengan environment baru dan sesi client tidak mengoverride-nya secara lokal. Version drift itu nyata di sini: pohon pengaturan sudah direorganisasi lebih dari sekali (Language Model, lalu AI Service Provider, dengan modul provider hadir di v1.44), dan screenshot dari tutorial lama tidak akan cocok dengan menu terkini. Field-nya sendiri, id, name, tipe SDK, URL, key, tetap stabil.
Siapa yang merutekan LobeChat melalui gateway.
- Self-hoster yang menjalankan LobeChat untuk tim yang ingin satu endpoint di container dan satu log penggunaan untuk semua orang, alih-alih key vendor per pengguna.
- Power user asisten yang mem-pin vendor berbeda per role, Claude untuk penulisan, GPT untuk analisis, DeepSeek untuk volume, tanpa memelihara akun untuk masing-masing.
- Pengguna yang ingin model yang tidak diangkut daftar provider bawaan, diaktifkan dengan mengambil katalog gateway alih-alih menunggu rilis upstream.
- Developer tanpa akses ke billing vendor tertentu. Akses berbasis top-up tanpa syarat kartu menghilangkan ketergantungan sign-up per provider.
- Orang yang sudah merutekan editor, launcher, atau tool CLI mereka melalui gateway yang ingin framework chat mereka pada key yang sama.
Verifikasi endpoint dan debug percakapan pertama.
Curl listing model dulu dan simpan outputnya terbuka; itu ejaan otoritatif untuk setiap id yang Anda aktifkan, baik lewat fetch atau tangan. Lalu jalankan satu chat completion terhadap id yang Anda rencanakan jadikan default. Di dalam LobeChat, kerjakan pemeriksaan konektivitas sebelum percakapan nyata. Kegagalan autentikasi menunjuk ke field key. Balasan kosong menunjuk ke suffix /v1. Error not-found pada model tertentu berarti id yang diaktifkan tidak cocok dengan listing, yang paling sering terjadi setelah mengedit display name dan id secara manual bersamaan. Setelah percakapan mengalir, konsol APIsRouter menunjukkan model per request, hitungan token, dan pengeluaran. Framework chat dengan asisten menghasilkan traffic lintas beberapa model sekaligus, dan tampilan penggunaan per-key adalah tempat kebiasaan setiap asisten menjadi biaya yang bisa Anda lihat per model, per hari.
curl -s https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
curl -s https://api.apisrouter.com/v1/chat/completions \
-H "Authorization: Bearer $APISROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gemini-3.5-flash",
"messages":[{"role":"user","content":"ping"}]}'Pertanyaan umum
Bagaimana cara menambah provider OpenAI-compatible kustom ke LobeChat?
Di pengaturan, buka bagian AI service provider dan buat provider kustom: id dan display name, tipe SDK OpenAI, endpoint https://api.apisrouter.com/v1, dan key Anda. Ambil daftar model, aktifkan id yang Anda inginkan, dan jalankan pemeriksaan konektivitas.
Apakah URL endpoint butuh /v1?
Untuk APIsRouter, ya: https://api.apisrouter.com/v1. LobeChat menambahkan route seperti /chat/completions ke base yang Anda berikan, dan dokumentasinya mencatat suffix yang salah biasanya muncul sebagai balasan kosong pada tes. Jika Anda melihat itu, perbaiki suffix-nya dan coba lagi.
Apa itu OPENAI_PROXY_URL dan kapan saya menggunakannya?
Itu environment variable self-hosting yang mengarahkan ulang provider OpenAI bawaan LobeChat ke base URL lain. Atur itu dengan OPENAI_API_KEY di container dan setiap pengguna deployment itu mewarisi endpoint-nya; gunakan OPENAI_MODEL_LIST untuk mengurasi id mana yang muncul.
Bisakah asisten berbeda menggunakan vendor berbeda melalui satu provider?
Ya. Setiap asisten mem-pin model-nya sendiri, dan id-nya berjalan ke endpoint sebagai string biasa per request. Satu entri provider bisa melayani asisten Claude, asisten GPT, dan asisten DeepSeek berdampingan, semua ditagih melalui key yang sama.
Apakah LobeChat proyek yang sama dengan LobeHub?
Ya. Proyeknya rebranding dan repo GitHub-nya sekarang berada di lobehub/lobehub, dengan nama lobe-chat lama mengarahkan ke situ. Dokumentasi dan menu mencampur kedua nama selama transisi, yang juga sebabnya label pengaturan bervariasi antar rilis.
Mengapa model yang saya ambil tidak muncul di percakapan?
Mengambil hanya mendaftar id; mengaktifkannya adalah toggle terpisah per model di daftar model provider, dan provider itu sendiri punya sakelar aktifkan. Cek keduanya, lalu buka ulang picker model. Jika id yang diaktifkan masih error, bandingkan ejaannya dengan output /v1/models.