Open WebUI OpenAI API base URL adalah field kecil yang menentukan apakah Open WebUI mengirim traffic chat ke satu upstream provider, server model lokal, atau router seperti Flatkey. Untuk deployment tim, field ini tidak boleh diperlakukan sebagai detail copy-paste. Field ini harus diperiksa bersama API key, model ID, perilaku discovery model, chat completions, streaming, dan log penggunaan.
Panduan ini ditulis untuk developer, tim produk AI, pembuat automasi, engineer platform, operator finance, dan reviewer procurement yang ingin Open WebUI menggunakan Flatkey sebagai model router yang kompatibel dengan OpenAI. Panduan ini menunjukkan path koneksi Open WebUI saat ini, base URL Flatkey yang perlu diverifikasi, kapan menggunakan model filter, cara menjalankan preflight curl, dan apa yang perlu dicatat sebelum rollout setup ke lebih banyak pengguna.
Catatan sumber: ini diperiksa pada 29 Juni 2026 terhadap dokumentasi Open WebUI OpenAI-Compatible resmi, homepage Flatkey yang live, dan halaman harga Flatkey yang live. Tidak ada live API key Flatkey atau instance Open WebUI yang tersedia di runtime ini, jadi perintah di bawah adalah template untuk dijalankan dengan key, alias model, dan deployment Open WebUI milik Anda sendiri.
Jawaban cepat: Open WebUI OpenAI API base URL untuk Flatkey
Untuk route Flatkey, set Open WebUI OpenAI API base URL ke current provider base URL Flatkey dari akun Anda. Homepage publik Flatkey yang diperiksa untuk artikel ini mengatakan agar klien yang kompatibel dengan OpenAI diarahkan ke https://console.flatkey.ai/v1. Di Open WebUI, gunakan base URL tersebut, tempel API key Flatkey, tambahkan model ID Flatkey yang tepat jika discovery model berisik atau gagal, lalu simpan koneksinya.
| Field Open WebUI | Nilai Flatkey | Check review |
|---|---|---|
| URL | https://console.flatkey.ai/v1, kecuali akun Flatkey Anda menampilkan provider base URL yang lebih baru |
Gunakan hanya base URL. Jangan tempel /chat/completions ke field URL. |
| API Key | Key Flatkey yang dimiliki workspace, tim, atau environment yang benar | Gunakan scoped test key terlebih dahulu, lalu rotate atau pisahkan key untuk pengguna production. |
| Model IDs (Filter) | Alias model Flatkey yang tepat dan disetujui untuk Open WebUI | Tambahkan ini secara manual ketika verifikasi /models gagal, mengembalikan terlalu banyak model, atau mengekspos model yang tidak ingin dipilih pengguna. |
| Connection toggle | Diaktifkan hanya setelah preflight chat berhasil | Biarkan provider sebelumnya tetap tersedia sampai route Flatkey terbukti berfungsi. |
Versi singkatnya adalah: konfigurasi URL, key, dan model filter, lalu uji request chat dan konfirmasi bahwa request tersebut muncul di usage Flatkey. Sisa panduan Open WebUI OpenAI API base URL ini mengubahnya menjadi setup yang dapat diulang dan checklist troubleshooting.
Apa yang dikonfirmasi dokumentasi Open WebUI saat ini
Panduan resmi Open WebUI yang kompatibel dengan OpenAI mengatakan bahwa Open WebUI dapat terhubung ke server atau provider mana pun yang mengimplementasikan OpenAI-compatible API. Dokumentasi membingkai integrasi di sekitar protokol standar, terutama protokol OpenAI Chat Completions, bukan modul kustom untuk setiap provider. Itu membuat Flatkey menjadi tugas konfigurasi base URL, key, dan pemilihan model.
Panduan yang sama memberikan path admin saat ini: buka Open WebUI, masuk ke Admin Settings, lalu Connections, lalu OpenAI, kemudian klik Add Connection. Dari sana, isi URL provider dan API key. Jika discovery model otomatis tidak berfungsi, tambahkan model ID ke Model IDs (Filter) dan simpan.
Satu peringatan Open WebUI sangat penting untuk setup router. Ketika koneksi ditambahkan, Open WebUI memverifikasinya melalui endpoint /models milik provider dengan bearer token standar. Dokumentasi mengatakan beberapa provider tidak mengimplementasikan /models, menggunakan perilaku non-standar, atau mengembalikan daftar model yang terlalu panjang. Error daftar model tidak otomatis berarti chat completions tidak kompatibel. Itu berarti Anda mungkin perlu menambahkan model ID secara manual dan menguji endpoint chat secara langsung.
Untuk kompatibilitas penuh, Open WebUI mencantumkan /v1/models sebagai yang direkomendasikan dan /v1/chat/completions sebagai endpoint chat inti yang diperlukan. Open WebUI juga meneruskan parameter OpenAI yang umum seperti temperature, top_p, max_tokens atau max_completion_tokens, stop, seed, dan logit_bias. Penggunaan tool didukung ketika model dan server mendukung tools dan tool_choice.
Nilai Flatkey yang perlu diverifikasi sebelum mengubah Open WebUI
Homepage Flatkey yang diperiksa pada 29 Juni 2026 memiliki judul One API gateway for production AI teams dan menjelaskan akses model terpadu, routing, billing, analytics penggunaan, dan kontrol operasional. Halaman tersebut juga mengatakan bahwa tim harus mengarahkan klien yang kompatibel dengan OpenAI ke https://console.flatkey.ai/v1 dan mempertahankan pola SDK atau client yang sudah ada.
Halaman harga Flatkey yang dicek pada hari yang sama menunjukkan bahwa katalog publik memiliki 633 model yang diaktifkan di 23 provider. Halaman ini juga mengekspos keluarga endpoint termasuk /v1/chat/completions, /v1/responses, /v1/messages, /v1/images/generations, dan /v1/video/generations. Untuk chat Open WebUI, mulailah dengan model yang tersedia melalui jalur chat completions dan disetujui untuk key yang akan Anda gunakan.
Jangan berasumsi setiap model katalog adalah model Open WebUI yang baik. Open WebUI OpenAI API base URL mengarah ke sebuah router, tetapi pengalaman pengguna bergantung pada alias model yang dipilih, dukungan endpoint, latensi, perilaku konteks, dukungan tool, dan apakah model muncul dengan rapi di pemilih model Open WebUI.
Langkah demi langkah: tambahkan Flatkey sebagai koneksi OpenAI
- Pilih scope Open WebUI. Tentukan apakah ini koneksi untuk seluruh admin, instance uji, atau deployment self-hosted yang dikelola melalui environment variables.
- Buat atau pilih key Flatkey. Gunakan key khusus untuk pengujian Open WebUI agar penggunaan dapat dilacak dan dibatasi.
- Pilih satu model awal. Salin alias model yang persis dari harga Flatkey, konsol Flatkey, atau daftar model yang terlihat di akun Anda.
- Buka layar koneksi. Di Open WebUI, buka Admin Settings > Connections > OpenAI > Add Connection.
- Tempel URL Flatkey. Gunakan
https://console.flatkey.ai/v1jika akun Anda mengonfirmasikannya. Nilai harus menyertakan/v1tetapi bukan/chat/completions. - Tempel key Flatkey. Gunakan key yang dibuat untuk deployment Open WebUI ini, bukan key provider pribadi atau key upstream provider yang tidak terkait.
- Tambahkan ID model saat diperlukan. Jika discovery model gagal, menampilkan terlalu banyak opsi, atau mengekspos model di luar kebijakan, tambahkan alias yang disetujui secara tepat ke Model IDs (Filter).
- Simpan dan simpan rute sebelumnya di dekat Anda. Open WebUI memungkinkan koneksi diaktifkan atau dinonaktifkan, jadi pertahankan rute rollback saat melakukan pengujian.
- Jalankan satu prompt berisiko rendah. Gunakan prompt sederhana di Open WebUI, lalu konfirmasikan request di penggunaan Flatkey berdasarkan timestamp, key, model, jumlah token, dan biaya.
- Dokumentasikan pemiliknya. Catat siapa pemilik key, siapa yang dapat merotasinya, model mana yang disetujui, dan kuota apa yang berlaku sebelum memperluas akses.
Template variabel environment opsional
Jika deployment Anda dikelola melalui environment variables, gunakan nama yang didukung oleh versi dan metode deployment Open WebUI Anda. Contoh provider Open WebUI menunjukkan pola OPENAI_API_BASE_URL dan OPENAI_API_KEY untuk backend yang kompatibel dengan OpenAI, tetapi panel admin juga dapat mengelola koneksi. Perlakukan ini sebagai template deployment untuk diverifikasi terhadap versi Anda.
OPENAI_API_BASE_URL=https://console.flatkey.ai/v1
OPENAI_API_KEY=fk_replace_with_flatkey_key
Jika Anda juga merutekan embeddings, pembuatan gambar, speech, atau fitur gaya OpenAI lainnya melalui Open WebUI, konfigurasi variabel base URL dan key khusus fitur tersebut hanya setelah memastikan Flatkey dan model yang dipilih mendukung keluarga endpoint itu. Untuk rollout Open WebUI OpenAI API base URL pertama, fokuskan pengujian pada chat completions.
Preflight rute Flatkey sebelum menyalahkan Open WebUI
Preflight curl memisahkan masalah router dan kredensial dari masalah UI Open WebUI. Jalankan ini dari lokasi jaringan yang sebanding dengan server Open WebUI.
export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_BASE_URL="https://console.flatkey.ai/v1"
export FLATKEY_OPEN_WEBUI_MODEL="replace-with-flatkey-model-alias"
curl "$FLATKEY_BASE_URL/chat/completions" \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$FLATKEY_OPEN_WEBUI_MODEL"'",
"messages": [
{
"role": "user",
"content": "Kembalikan kata ok."
}
],
"stream": false,
"max_tokens": 16
}'Jika request itu gagal, perbaiki key Flatkey, URL, alias model, izin akun, atau rute jaringan sebelum mengubah Open WebUI lagi. Jika berhasil, ulangi melalui Open WebUI dan bandingkan log penggunaan Flatkey.
Untuk pengalaman chat streaming, uji streaming secara terpisah. Respons non-streaming membuktikan rute dapat menjawab. Itu tidak membuktikan bahwa reverse proxy Anda, deployment Open WebUI, dan browser klien menangani streaming tanpa buffering atau timeout.
curl "$FLATKEY_BASE_URL/chat/completions" \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$FLATKEY_OPEN_WEBUI_MODEL"'",
"messages": [
{
"role": "user",
"content": "Stream tiga poin singkat."
}
],
"stream": true,
"max_tokens": 96
}'Checklist discovery model dan filter
Setup Open WebUI OpenAI API base URL yang paling aman menggunakan filter model secara sengaja. Sebuah router dapat mengekspos banyak model, dan daftar model yang luas tidak selalu merupakan apa yang ingin dilihat admin oleh pengguna.
| Keputusan | Apa yang diperiksa | Mengapa ini penting |
|---|---|---|
| Alias model | ID model Flatkey yang tepat yang terlihat oleh kunci | Open WebUI mengirim string model sesuai konfigurasi. Nama tampilan saja tidak cukup. |
Penemuan /models |
Perilaku penyimpanan koneksi dan keluaran pemilih model | Open WebUI mungkin menampilkan error verifikasi bahkan ketika chat completions dapat berfungsi melalui allowlist manual. |
| Chat completions | /v1/chat/completions menghasilkan jawaban normal |
Ini adalah jalur chat Open WebUI yang diperlukan dalam tabel kompatibilitas resmi. |
| Streaming | Browser menerima output bertahap tanpa buffering yang lama | Streaming dapat gagal karena proxy atau perilaku runtime meskipun chat non-streaming berfungsi. |
| Tools | Model dan route mendukung tools dan tool_choice saat diperlukan |
Open WebUI hanya dapat meneruskan parameter tool jika backend yang dipilih mendukungnya. |
| Visibilitas penggunaan | Flatkey menampilkan timestamp, key, model, token, status, dan biaya | Tim platform dan keuangan memerlukan bukti bahwa route baru dapat diatribusikan. |
Mode kegagalan yang perlu di-debug terlebih dahulu
| Gejala | Penyebab yang mungkin | Perbaikan |
|---|---|---|
| Penyimpanan koneksi menampilkan error daftar model | Penemuan /models gagal, mengembalikan terlalu banyak model, atau tidak sesuai dengan ekspektasi Open WebUI |
Tambahkan ID model yang tepat ke Model IDs (Filter), simpan lagi, dan uji chat completions. |
| 401 atau key tidak valid | Key tersebut bukan key Flatkey, disalin dengan salah, sudah di-rotate, atau milik workspace yang salah | Generate key Flatkey khusus dan uji ulang dengan curl sebelum memperbarui UI. |
| 404 atau route tidak ditemukan | URL menyertakan endpoint penuh atau tidak menyertakan base path yang diperlukan | Gunakan https://console.flatkey.ai/v1 sebagai base URL saat akun Anda mengonfirmasikannya. |
| Model tidak ditemukan | Nilai model Open WebUI tidak cocok dengan alias Flatkey yang diaktifkan | Salin alias model yang tepat dari Flatkey dan tambahkan ke filter model. |
| Chat berfungsi, tetapi streaming terasa macet | Buffering reverse proxy, timeout server, atau masalah jalur browser/network | Uji streaming dengan curl, lalu periksa pengaturan timeout server Open WebUI dan proxy. |
| Pengeluaran tidak dapat direkonsiliasi | Key bersama, pemilik model tidak jelas, atau tidak ada catatan peluncuran | Gunakan key Flatkey khusus dan catat pemilik, environment, ID model, dan kuota sebelum memperluas akses. |
Runbook produksi untuk Open WebUI dan Flatkey
Sebelum Anda melakukan perubahan Open WebUI OpenAI API base URL untuk kelompok yang lebih luas, catat fakta operasional yang mendukung kepemilikan, rollback, dan review biaya.
| Field runbook | Catat ini |
|---|---|
| Deployment Open WebUI | URL, versi jika diketahui, pemilik, dan apakah koneksi dikelola admin atau dikelola environment. |
| Flatkey base URL | Base URL yang disetujui akun saat ini dan tanggal pengecekan. |
| Pemilik key Flatkey | Tim, environment, pemilik rotasi, kuota, dan pemilik alert. |
| Allowlist model | Alias model yang tepat yang diekspos ke pengguna Open WebUI dan alasan masing-masing disetujui. |
| Bukti endpoint | Pemeriksaan chat non-streaming, chat streaming, dan penggunaan tool jika relevan. |
| Bukti penggunaan | Baris penggunaan Flatkey yang menunjukkan key, timestamp, model, token, status permintaan, dan biaya yang diharapkan. |
| Rollback | Koneksi sebelumnya, rencana penonaktifan, jalur pencabutan key, dan persetujuan pemilik. |
Di mana ini cocok dalam klaster integrasi tool Flatkey
Open WebUI hanyalah salah satu surface yang dapat menggunakan route kompatibel OpenAI. Jika tim Anda menstandarkan beberapa tool, gunakan pola yang sama di seluruh klaster: satu base URL saat ini, satu key milik akun per surface, alias model yang tepat, smoke test kecil, bukti penggunaan, dan catatan rollback.
Untuk setup yang berdekatan, lihat panduan Cherry Studio API setup untuk disiplin base URL klien desktop, panduan CC Switch Claude Code Flatkey untuk routing tool developer, dan playbook OpenAI-compatible API migration yang lebih luas untuk perubahan base URL, verifikasi alias model, dan rollback. Gunakan Flatkey pricing untuk meninjau cakupan model dan endpoint saat ini, lalu dapatkan key untuk workspace yang memiliki rollout Open WebUI pertama.
FAQ
Apa yang harus saya isi di field Open WebUI OpenAI API base URL?
Gunakan base URL provider Flatkey saat ini dari akun Anda. Homepage publik Flatkey yang diperiksa pada 29 Juni 2026 mengarahkan klien yang kompatibel dengan OpenAI ke https://console.flatkey.ai/v1. Jangan sertakan path lengkap /chat/completions di field base URL.
Mengapa Open WebUI menampilkan error penemuan model?
Open WebUI memverifikasi koneksi baru yang kompatibel dengan OpenAI dengan memanggil /models. Dokumen resmi memperingatkan bahwa beberapa penyedia tidak mengimplementasikan endpoint tersebut, menggunakan perilaku non-standar, atau mengembalikan daftar model yang sangat besar. Jika chat completions berfungsi, tambahkan ID model yang tepat ke filter dan uji lagi.
Can I expose every Flatkey model to Open WebUI?
Secara teknis, sebuah router dapat mengekspos banyak model, tetapi admin produksi sebaiknya memulai dengan allowlist yang sempit. Pilih model yang sesuai dengan kebutuhan chat Open WebUI, dukungan endpoint, ekspektasi latensi, kebijakan penggunaan, dan kontrol anggaran.
Does Flatkey replace Open WebUI settings?
Tidak. Flatkey menyediakan route yang kompatibel dengan OpenAI, key, akses model, visibilitas penggunaan, dan kontrol penagihan. Open WebUI tetap mengontrol pengaturan koneksinya sendiri, pemilih model, akses pengguna, perilaku prompt, dan jaringan di level deployment.
How do I know the setup is working?
Jalankan preflight curl ke /chat/completions, simpan koneksi Open WebUI, kirim satu prompt yang aman, dan pastikan request muncul di penggunaan Flatkey dengan key, model, timestamp, token, status, dan biaya yang diharapkan.
Final checklist
- URL dasar Flatkey dikonfirmasi dari sumber akun saat ini.
- Key Flatkey khusus dibuat untuk deployment Open WebUI.
- Satu alias model chat yang disetujui dipilih terlebih dahulu.
- Open WebUI OpenAI API base URL diatur ke URL base penyedia, bukan endpoint lengkap.
- ID model ditambahkan secara manual saat discovery gagal atau mengembalikan terlalu banyak opsi.
- Chat non-streaming dan streaming diuji.
- Baris penggunaan Flatkey dikonfirmasi setelah prompt Open WebUI pertama.
- Pemilik, kuota, allowlist model, dan jalur rollback dicatat.
Setelah pemeriksaan tersebut lolos, Open WebUI OpenAI API base URL menjadi lebih dari sekadar field koneksi. Ini menjadi route Flatkey yang terkontrol dengan satu key, model yang disetujui, visibilitas penggunaan, dan rencana rollback yang jelas.
