Pengaturan API Kompatibel OpenAI di Open WebUI dalam 5 Menit
Untuk menggunakan pengaturan API kompatibel OpenAI di Open WebUI, Anda menambahkan satu koneksi dengan URL dasar dan kunci, lalu model muncul di pemilih. Berikut adalah pengaturan tepat untuk Abliterated API, mulai dari Docker hingga obrolan pertama.
Diperbarui

Poin utama
- URL dasar adalah https://api.abliteratedapi.com/v1 dan ID modelnya adalah
uncensored. - Tambahkan di pengaturan koneksi admin, atau teruskan OPENAI_API_BASE_URL dan OPENAI_API_KEY ke Docker.
- Uji kunci dengan curl terlebih dahulu, agar Anda dapat membedakan masalah kunci dari masalah antarmuka pengguna.
- Open WebUI hanyalah antarmuka depan: Anda membayar per token untuk apa yang dibaca dan ditulis model, dan tidak perlu kartu untuk memulai.
Versi singkatnya
Jika Anda ingin pengaturan API kompatibel OpenAI di Open WebUI dalam satu paragraf: buka pengaturan admin, tambahkan koneksi API OpenAI, atur URL ke https://api.abliteratedapi.com/v1, tempel kunci Anda, simpan, dan pilih model bernama uncensored. Itu saja. Open WebUI berbicara dengan apa pun yang mengimplementasikan format penyelesaian obrolan OpenAI, dan API ini melakukannya.
Layanan ini adalah API teks yang kompatibel dengan OpenAI yang di-host dan menjalankan satu model bobot terbuka, yang disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Layanan ini dijalankan oleh penyedia independen dan bukan API resmi dari laboratorium model mana pun. Open WebUI hanyalah antarmuka obrolan depan yang Anda arahkan ke sana.
Sebelum Anda memulai
- Kunci API. Buat di halaman kunci API. Pendaftaran dilakukan dengan Google atau dengan email dan kata sandi. Pengguna baru dapat mengklaim $0,50 kredit uji coba gratis dengan satu klik di halaman tersebut, berlaku selama 7 hari dan tidak memerlukan kartu.
- Open WebUI yang berjalan. Instalasi Docker atau instalasi pip sama-sama berfungsi. Langkah-langkah di bawah ini mencakup Docker dan layar pengaturan.
- Akses jaringan dari mesin yang menjalankan Open WebUI ke
api.abliteratedapi.commelalui HTTPS.
Periksa kunci sebelum menyentuh antarmuka pengguna. Jika panggilan ini mengembalikan daftar yang berisi uncensored, kunci dan URL sudah benar:
curl https://api.abliteratedapi.com/v1/models -H "Authorization: Bearer $ABLITERATED_API_KEY"
Kemudian konfirmasi bahwa completion nyata berfungsi:
curl https://api.abliteratedapi.com/v1/chat/completions -H "Authorization: Bearer $ABLITERATED_API_KEY" -H "Content-Type: application/json" -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'Metode 1: tambahkan koneksi di pengaturan
Ini adalah rute termudah dan berfungsi pada instalasi yang ada. Label menu berubah-ubah di antara versi Open WebUI, sehingga nama di bawah ini mungkin sedikit berbeda.
- Masuk ke Open WebUI sebagai admin dan buka Panel Admin, lalu Pengaturan, lalu Koneksi.
- Temukan bagian API OpenAI dan tambahkan koneksi baru dengan tombol tambah.
- Di bidang URL, masukkan
https://api.abliteratedapi.com/v1. Berhenti di/v1. Jangan tambahkan/chat/completions; aplikasi Open WebUI menambahkan path itu sendiri. - Tempel kunci Anda ke bidang kunci. Kunci tersebut dikirim sebagai
Authorization: Bearer <key>. - Gunakan tombol verifikasi di samping bidang jika versi Anda memilikinya, lalu simpan.
Buka obrolan baru dan buka pemilih model. Model uncensored harus ada dalam daftar, karena Open WebUI membacanya dari GET /v1/models. Jika daftar tetap kosong, buka bagian pemecahan masalah di bawah ini.
Metode 2: atur saat startup dengan Docker
Untuk instalasi baru, teruskan endpoint sebagai variabel lingkungan. Open WebUI membaca OPENAI_API_BASE_URL dan OPENAI_API_KEY saat dimulai.
# base URL: https://api.abliteratedapi.com/v1 model to pick in the UI: uncensored
docker run -d -p 3000:8080 -e OPENAI_API_BASE_URL="https://api.abliteratedapi.com/v1" -e OPENAI_API_KEY="$ABLITERATED_API_KEY" -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
Kemudian kunjungi http://localhost:3000, buat akun pertama (yang menjadi admin) dan mulai obrolan. Volume bernama menyimpan obrolan dan pengaturan Anda saat memperbarui kontainer.
Satu hal yang sering membuat orang bingung: banyak pengaturan Open WebUI disimpan ke database-nya setelah peluncuran pertama, dan nilai yang disimpan dapat menang atas variabel lingkungan yang diatur kemudian. Jika Anda mengubah kunci atau URL di Docker dan tidak ada perubahan, ubah di layar Koneksi, atau reset pengaturan yang tersimpan tersebut.
Pengaturan yang perlu disesuaikan
Setelah obrolan berfungsi, beberapa opsi membuat pengalaman lebih baik dan menjaga tagihan tetap dapat diprediksi.
Gunakan jendela konteks secara wajar
Jendela konteks adalah 100.000 token, yang dibagi antara prompt dan balasan. Open WebUI mengirim ulang riwayat obrolan pada setiap pesan, sehingga percakapan panjang menjadi lebih mahal setiap gilirannya. Pada $0,15 per 1 juta token input, riwayat 20.000 token biayanya $0,003 untuk dikirim, yang murah, tetapi jumlahnya bertambah di ribuan pesan. Mulai obrolan baru untuk topik baru.
Streaming dan sampling
Open WebUI mengalirkan balasan secara default, dan API mendukung streaming melalui SSE. Di parameter lanjutan, Anda dapat mengatur suhu, top_p, urutan henti, benih untuk output yang dapat diulang, dan penalti. Parameter ini diteruskan ke model. Biarkan max_tokens kosong kecuali Anda ingin batas keras, karena opsi ini tidak wajib.
Tugas latar belakang
Open WebUI dapat membuat panggilan model tambahan di latar belakang untuk hal-hal seperti penamaan obrolan. Setiap panggilan adalah permintaan nyata pada saldo Anda dan berkontribusi pada batas. Jika Anda melihat panggilan yang tidak Anda ketik, periksa pengaturan model tugas dan arahkan ke model yang bersedia Anda bayar, atau matikan fitur pembantu tersebut.
Presets dan prompt sistem
Open WebUI memungkinkan Anda menyimpan preset model di bagian workspace-nya: nama, model dasar, prompt sistem, dan parameter default. Buat satu di atas uncensored untuk setiap pekerjaan yang sering Anda lakukan, seperti asisten pengedit, peninjau kode, atau karakter untuk sesi fiksi interaktif. Prompt sistem singkat yang menyatakan peran, nada, dan format balasan lebih efektif daripada instruksi panjang yang ditempelkan ke setiap obrolan.
Di sinilah profil model membantu. Ini adalah model bobot terbuka yang disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, yang cocok untuk fiksi, roleplay, dan aplikasi gaya pendamping untuk dewasa, di mana penolakan di tengah adegan mengganggu alur. Ini tidak mengubah batas keras: tidak ada konten seksual yang melibatkan anak di bawah umur, kapan pun. Jaga preset dan instance bersama dalam aturan itu dan sesuai hukum di tempat Anda tinggal.
Jika orang lain menggunakan instance Open WebUI Anda, ingat bahwa mereka semua berbagi kunci Anda dan batasnya. Kunci penuh memungkinkan 8 permintaan paralel, sehingga sejumlah kecil pengguna aktif itu baik-baik saja, sementara kelompok besar yang mengobrol sekaligus dapat mencapai batas. Memberikan setiap orang atau tim kunci mereka sendiri menyebarkan beban dan membuat saldo lebih mudah dilacak.
Biaya untuk menjalankannya
Anda hanya membayar token, dari saldo prabayar: $0,15 per 1 juta token input dan $0,50 per 1 juta token output. Permintaan yang gagal atau ditolak tidak dikenakan biaya dan saldo tidak pernah kedaluwarsa. Pesan obrolan khas dengan 3.000 token riwayat dan balasan 400 token biayanya $0,00045 + $0,0002 = $0,00065, sehingga $10 penggunaan adalah sekitar 15.000 pesan.
Isi saldo (top-up) berkisar dari $20 hingga $500 dalam jumlah bulat apa pun, dengan +5% dari $50, +10% dari $100, dan +15% dari $200. Anda dapat membayar dengan kripto (USDT di jaringan TRC20, USDC di Base). Lihat halaman harga untuk detailnya. Saldo yang tersisa dikembalikan di header X-Balance-USD dari setiap respons API, jika Anda ingin memantaunya dari skrip.
Pemecahan Masalah
| Gejala | Penyebab yang mungkin | Perbaikan |
|---|---|---|
| Daftar model kosong | URL atau kunci salah | Jalankan uji curl untuk /v1/models. URL harus berakhir dengan /v1. |
| Koneksi ditolak atau waktu tunggu dari Docker | Tidak ada HTTPS keluar dari kontainer | Periksa pengaturan DNS, proxy, dan firewall di host. |
| Kesalahan autentikasi pada setiap pesan | Kunci yang ditempel dengan spasi, atau kunci lama | Salin ulang kunci dari halaman kunci dan simpan lagi. |
| Kesalahan saat beberapa orang mengobrol secara bersamaan | Batas laju | Kunci penuh memungkinkan 8 permintaan konkuren dan 300 per menit; kunci uji coba memungkinkan 2 dan 60. |
| Obrolan panjang berhenti berfungsi | Jendela konteks penuh | Jendela tersebut memiliki kapasitas 100.000 token. Mulai obrolan baru atau buat ringkasan. |
Jika pengujian curl berhasil tetapi Open WebUI gagal, masalahnya ada di pengaturan front end. Jika curl gagal, periksa kunci dan saldo Anda terlebih dahulu. Panduan memulai cepat di dokumentasi mencantumkan setiap parameter permintaan, dan artikel tentang apa yang dimaksud dengan API obrolan tanpa sensor dan apa yang tidak menjelaskan cakupan model, termasuk batas keras: tidak ada konten seksual yang melibatkan anak di bawah umur.
Panduan lainnya
Tanya jawab
URL apa yang saya masukkan di Open WebUI?
Gunakan https://api.abliteratedapi.com/v1 dan tidak ada yang lain setelahnya. Open WebUI menambahkan /chat/completions dan /models secara otomatis.
Nama model mana yang saya pilih?
ID modelnya adalah uncensored. ID ini muncul di pemilih model setelah koneksi disimpan dan daftar model dimuat.
Apakah saya memerlukan kartu untuk mencobanya?
Tidak. Pengguna baru dapat mengklaim kredit uji coba gratis senilai $0,50 dengan satu klik di halaman kunci API setelah mendaftar. Kredit ini berlaku selama 7 hari dan tidak memerlukan kartu.
Bisakah saya menjalankannya bersama model lokal?
Ya. Open WebUI mendukung beberapa koneksi secara bersamaan, sehingga endpoint ini dapat berdampingan dengan model lokal dan masing-masing akan muncul di pemilih model yang sama.
Apakah obrolan saya digunakan untuk pelatihan?
Tidak. Prompt yang dikirim ke API tidak digunakan untuk pelatihan. Riwayat obrolan yang disimpan oleh Open WebUI tetap berada di instalasi Anda sendiri.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.
Dapatkan kunci API