# Open WebUI (/id/docs/guides/open-webui)

Chat dengan model cheapaimodel di Open WebUI lewat koneksi OpenAI API.



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](https://console.cheapaimodel.ai/keys) di Konsol |
| ID model | Pemilih model, atau **Advanced → Model IDs** | `deepseek-v4-1-flash`, atau ID apa pun dari [katalog](/id/models)               |

## Penyiapan [#set-it-up]

<Steps>
  <Step>
    ### Tambahkan koneksi [#add-the-connection]

    1. Masuk sebagai admin, lalu buka **Settings → Admin → Connections**.
    2. Di samping **Manage OpenAI API Connections**, klik **Add Connection*&#x2A; (tombol &#x2A;*+**).
    3. Atur **URL** ke `https://api.cheapaimodel.ai/v1`.
    4. Biarkan **Auth** di **Bearer**, lalu tempel key cheapaimodel kamu di **API Key**.
    5. Biarkan **API Type** di **Chat Completions**.
    6. Klik **Verify Connection**, lalu **Save**.
  </Step>

  <Step>
    ### Pilih model [#pick-a-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.
  </Step>
</Steps>

## Variabel lingkungan [#environment-variables]

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:

```bash title="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 [#documents-and-knowledge]

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 [#common-mistakes]

* **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](/id/models). 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**.