Open WebUI
UI chat self-host mirip ChatGPT. Settings → Connections → OpenAI API.
Base URL dan API key diambil dari dasbor RouterKu (menu Integrasi & Kunci API). Pada contoh, ganti BASE_URL_DARI_DASBOR (berakhiran /v1), HOST_DARI_DASBOR (tanpa /v1) dan qdr-... dengan nilai milikmu.
Open WebUI adalah antarmuka chat self-host mirip ChatGPT. RouterKu ditambahkan sebagai satu koneksi OpenAI, lalu semua model RouterKu otomatis muncul di pemilih model.
Nilai koneksi
| Base URL | BASE_URL_DARI_DASBOR |
| API Key | qdr-... (buat di menu Kunci API) |
| Model | sonnet-5 / opus-5 |
Langkah-langkah
Buat kunci RouterKu
Menu
Kunci API→ Buat kunci → salin (qdr-...).Buka pengaturan koneksi
Klik foto profil (pojok kiri bawah) → Admin Panel → Settings → Connections.
Tambah koneksi OpenAI
Di bagian OpenAI API, klik tombol + (Add Connection) dan isi:
API Base URL BASE_URL_DARI_DASBORAPI Key qdr-...Klik ikon segarkan untuk verifikasi, lalu Save.
Pilih model & chat
Buka chat baru → pilih
sonnet-5di pemilih model (model RouterKu ditarik otomatis dari/v1/models).
Lewat environment (Docker)
Saat menjalankan container, bisa juga langsung set:
OPENAI_API_BASE_URL=BASE_URL_DARI_DASBOR
OPENAI_API_KEY=qdr-...Model yang disarankan
opus-5 | Terkuat — penalaran mendalam untuk tugas berat, banyak tool, dan agen coding. |
sonnet-5 | Andalan harian (default) — seimbang antara kualitas, kecepatan, dan biaya. |
haiku-55 | Tercepat & termurah — balasan chat ringan, klasifikasi, dan boilerplate. |
Tips
- Bisa punya banyak koneksi sekaligus — tambah koneksi lain tanpa menghapus yang ada.
- Kalau daftar model tak muncul, pastikan Base URL berakhiran
/v1dan koneksi Enabled. - Fitur RAG/Documents Open WebUI tetap jalan dengan model RouterKu.
Kalau bermasalah
- 401 / authentication failed / invalid_api_key — cek dulu apakah kuncinya memang mati, atau cuma tidak sampai ke permintaan. Jalankan uji mandiri di bawah: kalau balasannya
200, kunci kamu SEHAT dan masalahnya ada di konfigurasi Open WebUI (lihat 3 poin berikutnya). Kalau bukan200, buat kunci baru di menuKunci API. - 401 padahal kunci sehat (1) — belum restart Open WebUI. Banyak aplikasi hanya membaca file
.env/variabel lingkungan saat start. Setelah mengubah kunci, tutup penuh lalu jalankan ulang Open WebUI. - 401 padahal kunci sehat (2) — penulisan kunci kotor. Di file
.envtulis polos tanpa kutip/spasi:ROUTERKU_API_KEY=qdr-...(bukan= "qdr-..."). Pastikan tidak ada spasi di ujung dan kunci tersalin utuh (tanpa terpotong). - 401 padahal kunci sehat (3) — nama variabel salah. Rujukan seperti
${ROUTERKU_API_KEY}umumnya hanya dikenali bila namanya HURUF BESAR dan variabelnya benar-benar ada; kalau tidak, teks${...}terkirim mentah sebagai kunci → 401. Saat ragu, isi kunciqdr-...langsung untuk memastikan. - 402 / insufficient_balance — saldo habis. Isi lewat menu
Isi Saldo. - 404 / model_not_found — ID model salah. Pakai persis, mis.
sonnet-5(daftar diGET /v1/models). - Tidak konek / timeout — pastikan Base URL berakhiran
/v1dan bisa diakses dari mesin Open WebUI. - 429 / rate_limited — melewati 240 permintaan/menit atau 24 paralel. Beri jeda atau kurangi konkurensi.
Uji mandiri kunci — jalankan di terminal mesin yang sama. Ganti qdr-... dengan kuncimu:
curl -s -o /dev/null -w "%{http_code}\n" BASE_URL_DARI_DASBOR/chat/completions \
-H "Authorization: Bearer qdr-..." \
-H "Content-Type: application/json" \
-d '{"model":"haiku-55","max_tokens":10,"messages":[{"role":"user","content":"ping"}]}'200 = kunci dan saldo RouterKu sehat, jadi penyebab 401 ada di konfigurasi aplikasinya (paling sering: aplikasi belum di-restart setelah kunci diubah). Hasil 401 = kunci salah/dicabut → buat ulang di menu Kunci API. Hasil 402 = saldo habis → menu Isi Saldo.Aplikasi chat gaya ChatGPT lain
Siap mulai pakai AI tanpa ribet?
Daftar gratis, isi saldo mulai Rp20.000 lewat QRIS, dan langsung tancap gas di editor atau aplikasimu.