Dokumentasi

Open WebUI

Open WebUI memperlakukan endpoint apa pun yang kompatibel dengan OpenAI sebagai koneksi. Tambahkan koneksi melalui Pengaturan Admin, atau tetapkan dua variabel lingkungan saat container dimulai — kedua cara tersebut menghasilkan koneksi yang sama.

Satu koneksi OpenAI di Admin Settings, atau OPENAI_API_BASE_URL dan OPENAI_API_KEY saat container dimulai — keduanya berakhir pada /v1 yang sama.

Koneksi, atau docker run

# Settings → Admin Settings → Connections → Manage OpenAI API Connections → +
URL                https://api.kunavo.com/v1
API Key            sk-kn-...
Model IDs (Filter) claude-sonnet-5, claude-opus-5, claude-haiku-4-5, gpt-5-6-terra

# …or at container start, same thing:
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.kunavo.com/v1 \
  -e OPENAI_API_KEY=sk-kn-... \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main

Isi Model IDs (Filter). Tanpanya, pemilih akan menampilkan seluruh katalog — termasuk model gambar, video, dan musik yang tidak dapat dipanggil oleh jendela chat — sehingga klik pertama pengguna akan mengarah ke salah satunya. Filter ini juga berguna saat endpoint tidak memiliki rute /models; Kunavo memilikinya, jadi verifikasi berhasil dengan kedua cara.

URL harus tetap menyertakan /v1. Jika Open WebUI berjalan di Docker dan Anda mengarahkannya ke sesuatu di host yang sama, ganti localhost dengan host.docker.internal — hal itu tidak berlaku untuk endpoint terkelola, tetapi merupakan masalah yang sering ditemui setelah masalah ini.

Belum punya kunci? Buat akun Kunavo, buat kunci (diawali sk-kn-) dan tambahkan kredit mulai dari $10 — panggilan dibayar dari saldo tersebut, dan panggilan yang gagal tidak ditagihkan. Dasbor kemudian terbuka pada penyiapan Open WebUI.

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Di Open WebUI, buka Settings → Admin → Connections, lalu cari Manage OpenAI API Connections.
Klik ➕ Add Connection, lalu masukkan URL dan Kunci API.
Tambahkan ID yang Anda inginkan ke Model IDs (Filter), lalu simpan dan biarkan koneksi diverifikasi.
Mulai chat baru — model akan muncul di pemilih dengan awalan nama koneksi.

Diperiksa terhadap Panduan penyedia yang kompatibel dengan OpenAI dari Open WebUI pada 6 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 Open WebUI.

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

ID model	Kunavo masuk / keluar	Kegunaannya di Open WebUI
`claude-sonnet-5`	$1.40 / $7.00	default chat umum
`claude-opus-5`	$3.50 / $17.50	percakapan analitis yang panjang
`claude-haiku-4-5`	$0.70 / $3.50	cepat, murah, dan memadai untuk sebagian besar giliran
`gpt-5-6-terra`	$0.70 / $4.20	dokumen panjang yang ditempel ke jendela chat

Penagihan dilakukan per token dari saldo prabayar tanpa biaya bulanan — lihat penagihan. Pada konteks berulang — yang merupakan sebagian besar kiriman editor atau klien obrolan — caching prompt lebih memengaruhi tagihan daripada pilihan model.

Pertanyaan umum

Bagaimana cara menghubungkan Open WebUI ke API yang kompatibel dengan OpenAI?

Buka Settings → Admin → Connections, buka "Manage OpenAI API Connections", lalu klik Add Connection. Masukkan URL endpoint — root /v1 — dan kunci API. Hal yang sama dapat dilakukan saat container dimulai dengan variabel lingkungan OPENAI_API_BASE_URL dan OPENAI_API_KEY. Kedua cara tersebut membuat koneksi yang sama.

Apa fungsi Model IDs (Filter) di Open WebUI?

Pengaturan ini membatasi ID model dari koneksi tersebut yang muncul di pemilih, dan juga menjadi opsi cadangan untuk endpoint yang tidak menyediakan rute /models — dalam kasus itu, tambahkan ID secara manual dan verifikasi akan gagal meski chat tetap berfungsi. Pada gateway dengan katalog multimodal yang besar, sebaiknya pengaturan ini tetap diisi agar pemilih chat hanya menampilkan model yang benar-benar dapat dipanggil oleh jendela chat.

Apakah URL dasar Open WebUI menyertakan /v1?

Ya. Open WebUI hanya menambahkan rute ke URL yang Anda berikan, jadi URL koneksinya adalah root /v1 — https://api.example.com/v1. Contoh endpoint dalam dokumentasinya sendiri menyertakan akhiran tersebut. Tanpanya, koneksi tersimpan, tetapi setiap permintaan menghasilkan 404.

Bisakah Open WebUI menggunakan model Claude dan GPT?

Ya, jika model tersebut disediakan melalui endpoint yang kompatibel dengan OpenAI. Open WebUI mengirimkan ID model langsung ke URL koneksi, sehingga ID dari vendor mana pun diselesaikan di endpoint, bukan di Open WebUI. Artinya, satu koneksi dan satu kunci dapat menempatkan ID Claude dan GPT dalam pemilih model yang sama.