Sambungkan Open WebUI ke endpoint custom serasi OpenAI.

Jawapan pantas: satu sambungan dalam Admin Settings.

Sebagai pentadbir, buka Admin Settings, pergi ke Connections, dan di bawah bahagian OpenAI API klik untuk menambah sambungan. Dua medan penting: URL, ditetapkan kepada https://api.apisrouter.com/v1, dan kunci API. Simpan, dan Open WebUI menyoal senarai /v1/models endpoint untuk mengisi pemilih model; sahkan dengan kawalan semak sambungan itu, kemudian pilih mana-mana id katalog dalam sembang baharu. Sambungan yang ditambah dengan cara ini adalah seluruh ruang kerja: setiap pengguna instans Open WebUI anda melihat model itu, tertakluk kepada apa sahaja kawalan akses model yang anda konfigurasikan. Nilai yang sama boleh dihantar sebagai pembolehubah persekitaran pada masa penempatan sebaliknya, OPENAI_API_BASE_URL dan OPENAI_API_KEY, iaitu laluan lebih bersih apabila instans itu diperuntukkan oleh fail compose dan bukan diklik ke dalam bentuk.

URL:      https://api.apisrouter.com/v1
API Key:  sk-YOUR-APISROUTER-KEY

Save → model terisi automatik daripada /v1/models
(pilihan) Senarai benar Model IDs untuk menyusun pemilih

Bagaimana Open WebUI menggunakan sambungan OpenAI.

Open WebUI (lebih kurang 145K bintang GitHub) ialah antara muka sembang AI hos-sendiri lalai: klien web berciri lengkap dengan pengguna dan kebenaran, koleksi RAG dan pengetahuan, panggilan alat, dan pengurusan model, klasiknya digandingkan dengan Ollama untuk model tempatan tetapi sama selesa bertutur dengan API jauh. Model sambungannya adalah tambahan. Bahagian Ollama merangkumi runtime tempatan; bahagian OpenAI API merangkumi mana-mana endpoint yang bertutur dialek chat-completions standard, dan anda boleh menambah beberapa sambungan berdampingan. Setiap sambungan menyumbang senarai modelnya kepada pemilih yang dikongsi, masing-masing mempunyai kunci sendiri, dan masing-masing boleh ditogol mati tanpa memadam konfigurasinya. Permintaan membawa id model sebagai rentetan biasa kepada mana-mana sambungan yang melayaninya. Reka bentuk itu bermaksud sambungan gateway tidak menggantikan apa-apa: model tempatan anda terus berjalan melalui Ollama tanpa kos per-token, manakala claude-sonnet-4-6, gpt-5.5, gemini-3.5-flash, dan deepseek-v4-pro menjadi entri pemilih untuk perbualan yang memerlukan kualiti frontier. Satu kunci merangkumi semuanya, dan penggunaan sisi pentadbir kekal terbaca kerana trafik awan keluar melalui tepat satu tempat.

Persediaan masa penempatan: pembolehubah persekitaran.

Untuk penempatan docker-compose dan Kubernetes, sambungan itu boleh menjadi sebahagian manifes. OPENAI_API_BASE_URL mengambil endpoint dan OPENAI_API_KEY kunci itu; instans itu muncul dengan sambungan sudah hadir. Berbilang endpoint disokong melalui bentuk jamak (OPENAI_API_BASE_URLS dan OPENAI_API_KEYS dengan nilai dipisahkan koma bertitik) jika anda menjalankan lebih daripada satu sumber jauh. Dua nota operasi. Pertama, nilai yang ditetapkan melalui UI kekal dalam pangkalan data Open WebUI dan mengatasi lalai persekitaran selepas but pertama, tingkah laku terdokumentasi yang kerap mengejutkan operator yang menukar env dan melihat tiada apa berlaku; laraskan sambungan sedia ada dalam Admin Settings, atau tetapkan ENABLE_PERSISTENT_CONFIG=false jika anda mahu persekitaran kekal berwibawa. Kedua, jika senarai model endpoint besar, guna senarai benar Model IDs sambungan itu untuk menyusun apa yang dilihat pengguna anda; pemilih empat-item digunakan, yang dua-ratus-item diskrol lalu. Nota versi: perkataan menu telah bergerak merentas kadar keluaran pantas projek ini (Settings vs Admin Settings, nama bahagian di dalam Connections), jadi pada binaan lebih lama cari pasangan URL asas OpenAI API dan kunci di mana sahaja sambungan berada.

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    environment:
      - OPENAI_API_BASE_URL=https://api.apisrouter.com/v1
      - OPENAI_API_KEY=sk-YOUR-APISROUTER-KEY
    ports:
      - "3000:8080"

Memilih model untuk ruang kerja berbilang pengguna.

Dengan setiap model awan dibilkan melalui satu kunci, ujian A/B adalah pilihan pemilih. Jalankan beban kerja pasukan yang sama dua minggu berjauhan pada dua lalai calon dan biarkan pandangan penggunaan per-model dalam konsol APIsRouter menjadi hakim, per model dan per hari, dan bukan meneka daripada tanda aras.

• Pilihan model lalai melakukan kerja paling banyak dalam instans dikongsi. claude-haiku-4-5-20251001 atau gemini-3.5-flash sebagai lalai ruang kerja mengekalkan kos per-perbualan penggunaan biasa rata.
• claude-sonnet-4-6 dan gpt-5.5 tergolong dalam pemilih untuk merangka, analisis, dan soalan kod; pengguna naik apabila tugas itu layak menerimanya.
• Saluran paip RAG menggandakan token input: setiap jawapan membawa serpihan yang diambil. deepseek-v4-pro berbaloi diuji sebagai kuda beban RAG, di mana pengendalian konteks-panjang per token yang dibelanjakan adalah sifat menentukan.
• Kekalkan bahan benar-benar peribadi pada model tempatan melalui Ollama dan halakan segala yang lain melalui gateway; pemilih memegang kedua-dua lorong dengan jujur.
• Guna senarai benar Model IDs sebagai polisi: apa yang tiada dalam pemilih tidak boleh mengejutkan anda pada log penggunaan.

Bayar mengikut penggunaan · bawah harga rasmi

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Mod kegagalan khusus Open WebUI.

Tiada model muncul selepas menambah sambungan adalah laporan paling biasa. Punca mengikut kedudukan: kunci gagal terhadap /v1/models (semak dengan kawalan pengesahan sambungan itu), URL hilang akhiran /v1, atau togol sambungan dimatikan. Open WebUI membina pemilih daripada apa yang dikembalikan senarai itu, jadi pemilih kosong bermaksud panggilan senarai gagal atau mengembalikan tiada apa. Perubahan persekitaran yang kelihatan diabaikan adalah peraturan konfigurasi-berterusan yang diterangkan di atas: selepas but pertama, pangkalan data mengatasi persekitaran untuk tetapan yang diurus UI. Edit sambungan dalam Admin Settings atau matikan konfigurasi berterusan secara eksplisit. Model yang tersenarai tetapi memberi ralat semasa sembang biasanya id yang didedahkan senarai tetapi kunci anda tidak boleh gunakan, atau kesilapan taip yang diperkenalkan dengan mengedit senarai benar Model IDs secara manual; banding berbanding output mentah /v1/models. Dan kekalkan lorong betul semasa menyahpepijat: masalah sambungan Ollama dan masalah sambungan OpenAI kelihatan sama daripada tetingkap sembang. Halaman Connections menunjukkan lorong mana model itu tergolong; uji lorong yang gagal secara terus sebelum menganggap seluruh instans mati.

Siapa yang menghalakan Open WebUI melalui gateway.

• Pasukan yang hos sendiri satu antara muka sembang untuk semua orang yang mahu model frontier tersedia tanpa mengeluarkan kunci vendor kepada pengguna individu.
• Pengguna Ollama yang mengekalkan model tempatan untuk kerja peribadi tetapi mahu kualiti Claude dan GPT dalam pemilih yang sama untuk perbualan yang memerlukannya.
• Pentadbir yang memerlukan bil awan yang terbaca: satu sambungan, satu kunci, dan log penggunaan per-model dan bukan resit daripada empat vendor.
• Operator di rantau di mana sesetengah pendaftaran vendor menyakitkan; akses berasaskan top-up tanpa keperluan kad menghapuskan kebergantungan setiap penyedia.
• Homelabber yang menjalankan Open WebUI untuk isi rumah, di mana satu baki prabayar lebih mudah dinilai daripada mana-mana langganan.

Sahkan endpoint dan nyahpepijat sembang pertama.

Buktikan endpoint daripada pelayan dahulu, terutama pada penempatan berbekas di mana rangkaian bekas bukan komputer riba anda. Senarai model dan satu chat completion daripada dalam hos mengesahkan separuh gateway sebelum Open WebUI masuk gambar. Kemudian tambah sambungan dan perhatikan pemilih terisi. Ralat pengesahan adalah medan kunci; pemilih kosong adalah panggilan senarai; laluan tergandakan (/v1/v1/...) dalam log pelayan bermaksud medan URL sudah membawa /v1 dan sesuatu melampirkan satu lagi, jadi baca URL tepat seperti disimpan. Sebaik sahaja sembang mengalir, konsol APIsRouter menunjukkan model per permintaan, kiraan token, dan perbelanjaan. Bagi instans berbilang pengguna ini adalah nombor yang penting: model mana yang benar-benar dipilih pengguna anda, dan apa yang benar-benar dikos seminggu ruang kerja itu, per model, per hari, pada satu halaman.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

Soalan lazim