Open WebUI

Open WebUI terhubung ke layanan yang kompatibel dengan OpenAI lewat koneksi OpenAI API, yang ditambahkan admin di Settings → Admin → Connections. Setelah koneksi disimpan, model-modelnya muncul di pemilih model semua pengguna.

	Pengaturan Open WebUI	Nilai
Base URL	URL	`https://api.cheapaimodel.ai/v1`
API key	API Key (dengan Auth di Bearer)	Key kamu dari halaman API key di Konsol
ID model	Pemilih model, atau Advanced → Model IDs	`deepseek-v4-1-flash`, atau ID apa pun dari katalog

Penyiapan

Tambahkan koneksi

Masuk sebagai admin, lalu buka Settings → Admin → Connections.
Di samping Manage OpenAI API Connections, klik Add Connection (tombol +).
Atur URL ke https://api.cheapaimodel.ai/v1.
Biarkan Auth di Bearer, lalu tempel key cheapaimodel kamu di API Key.
Biarkan API Type di Chat Completions.
Klik Verify Connection, lalu Save.

Pilih model

Open WebUI membaca daftar model dari /v1/models, yang mengembalikan model-model yang boleh dipakai key kamu. Pilih deepseek-v4-1-flash di pemilih model, lalu mulai chat.

Kalau mau menawarkan beberapa model saja, tambahkan ID-nya di Advanced → Model IDs; setelah itu Open WebUI hanya menampilkan model-model tersebut dan berhenti mengambil daftar. Kalau ada koneksi lain yang melayani ID yang sama, atur Prefix ID seperti cheapaimodel: modelnya muncul sebagai cheapaimodel.deepseek-v4-1-flash, dan Open WebUI membuang awalan itu sebelum mengirim permintaan.

Variabel lingkungan

Di instalasi baru, kamu juga bisa membuat koneksi yang sama saat Open WebUI dijalankan. Tambahkan kedua variabel ini ke perintah atau file Compose yang kamu pakai untuk menjalankan Open WebUI:

Terminal

docker run -d -p 3000:8080 \
  -v open-webui:/app/backend/data \
  -e OPENAI_API_BASE_URL="https://api.cheapaimodel.ai/v1" \
  -e OPENAI_API_KEY="$CHEAPAIMODEL_API_KEY" \
  --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main

Open WebUI hanya membaca variabel ini saat pertama kali dijalankan, lalu menyimpan nilainya di database. Untuk mengubah koneksi nanti, buka Settings → Admin → Connections.

Dokumen dan pengetahuan

cheapaimodel belum punya model embeddings. Di Settings → Admin → Documents, biarkan embedding engine memakai model bawaan Open WebUI atau penyedia lain; jangan arahkan ke cheapaimodel. Image :slim tidak punya model embedding bawaan, jadi untuk RAG di image itu kamu butuh embeddings dari penyedia lain.

Kesalahan umum

Verify Connection gagal dengan 404 dan fault filter abort, dan tidak ada model yang muncul. URL tidak menyertakan /v1. Atur ke https://api.cheapaimodel.ai/v1.
Setiap pesan gagal dengan 404 dan Invalid URL (POST /v1/chat/completions/chat/completions). URL menyertakan path endpoint. Open WebUI sudah menambahkan path-nya sendiri; atur ke https://api.cheapaimodel.ai/v1.
401. Key-nya salah, sudah kedaluwarsa, atau anggarannya habis, atau Auth tidak di Bearer. Cek key-nya di Konsol.
503 dengan model_not_found. ID yang diketik di Model IDs tidak cocok dengan katalog. Perbaiki ejaannya, atau kosongkan daftar itu supaya daftar model diambil dari /v1/models.
Perubahan variabel lingkungan tidak berpengaruh. Variabel itu hanya berlaku saat pertama kali dijalankan. Ubah koneksinya di Settings → Admin → Connections.