APIMaster.ai

Kunci API Open WebUI — Pengaturan Penyedia OpenAI Kustom

Cara menyiapkan Open WebUI dengan Docker dan mengonfigurasi APIMaster.ai sebagai koneksi kustom yang kompatibel dengan OpenAI. Tambahkan kunci API dan URL dasar di Pengaturan → Koneksi untuk mengakses model GPT-5.4, Claude, dan DeepSeek.

Open WebUI adalah antarmuka obrolan yang dihosting sendiri untuk LLM. APIMaster.ai menyediakan API yang kompatibel dengan OpenAI di https://apimaster.ai/v1 — konfigurasikan di bawah Koneksi untuk menggunakan model dari marketplace.

Dapatkan Kunci API terlebih dahulu. ID model yang Anda pilih dalam obrolan harus sama persis dengan marketplace (mis. gpt-5.4, claude-sonnet-4-6).


Prasyarat

  1. Docker terinstal (macOS, Linux, atau Windows).
  2. Konektivitas WebSocket diizinkan (diperlukan oleh Open WebUI — lihat Panduan Memulai Cepat resmi).
  3. Kunci API APIMaster dari konsol.

Langkah 1 — Instal Open WebUI dengan Docker

Tiga langkah ini mengikuti Panduan Memulai Cepat Open WebUI dengan Docker.

1.1 Tarik image

docker pull ghcr.io/open-webui/open-webui:main

Setara di Docker Hub: openwebui/open-webui:main.

1.2 Jalankan kontainer

docker run -d -p 3000:8080 \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main
Bendera Tujuan
-p 3000:8080 UI di http://localhost:3000
-v open-webui:/app/backend/data Penyimpanan persisten

Untuk produksi, tentukan tag rilis (mis. :v0.9.6) — lihat varian image.

1.3 Buka UI

http://localhost:3000

Akun pertama yang dibuat menjadi Administrator; pendaftaran selanjutnya membutuhkan persetujuan (setelah instalasi).


Langkah 2 — Buka pengaturan Koneksi

  1. Masuk sebagai admin.
  2. Buka PengaturanKoneksi.
  3. Di bawah API OpenAI, nyalakan sakelar utama ke posisi on.
  4. Atur URL menjadi:
https://apimaster.ai/v1

Pengaturan → Koneksi

Gunakan roda gigi atau + di samping URL untuk membuka editor koneksi (langkah selanjutnya).


Langkah 3 — Edit koneksi APIMaster

Di Edit Koneksi:

Bidang Nilai
URL https://apimaster.ai/v1
Otorisasi Bearer
Kunci API Kunci APIMaster Anda
Penyedia Default
Tipe API Chat Completions
ID Model Biarkan kosong — memuat model dari https://apimaster.ai/v1/models

Edit Koneksi

Biarkan Header dan ID Prefiks kosong. Aktifkan toggle koneksi, lalu Simpan.


Langkah 4 — Pilih model dan obrolan

  1. Buka Obrolan Baru.
  2. Buka Pilih model dan pilih model APIMaster (mis. gpt-5.4).
  3. Secara opsional Atur sebagai default.
  4. Kirim pesan uji coba.

Pemilih model

Sesi obrolan

Jika model tidak ada, periksa kunci Anda, akses grup, dan ID model marketplace; Anda juga dapat menambahkan ID tertentu di bawah ID Model.


FAQ

Daftar model kosong atau error koneksi

  • URL harus https://apimaster.ai/v1.
  • Validasi kunci dengan permintaan pertama.
  • Pastikan https://apimaster.ai/v1/models dapat dijangkau dari mesin Anda.

WebSocket / pembaruan langsung

Open WebUI memerlukan dukungan WebSocket; konfigurasikan proksi balik Anda jika tidak menggunakan localhost.

Pembaruan

Lihat Memperbarui Open WebUI: hapus kontainer → tarik image → jalankan lagi dengan volume yang sama.


Lihat juga