Tambahkan setiap model katalog ke Chatbox dengan satu provider kustom.

Updated 2026-07-29

Chatbox menyediakan alur Add Custom Provider untuk endpoint OpenAI-compatible apa pun: pilih mode OpenAI API Compatible, atur API Host ke https://api.apisrouter.com/v1, tempel satu key, dan id Claude, GPT, Gemini, dan DeepSeek duduk berdampingan di picker model pada desktop, mobile, dan web.

Jawaban singkat: satu dialog di pengaturan Model Provider.

Buka Settings Chatbox dan pindah ke tab Model Provider. Klik Add, lalu Add Custom Provider. Isi dialog dengan lima nilai: sebuah Name (APIsRouter), API Mode diatur ke OpenAI API Compatible, key Anda di API Key, https://api.apisrouter.com/v1 di API Host, dan biarkan API Path pada default /chat/completions yang diisi Chatbox untuk host yang berakhir /v1. Lalu tambahkan model. Tombol Fetch menarik daftar model endpoint melalui /v1/models sehingga Anda bisa mengaktifkan id langsung dari katalog, dan New membiarkan Anda mengetik id dengan tangan jika Anda lebih suka picker terkurasi yang singkat. Klik Check di sebelah field key dan Chatbox menjalankan request live; konfirmasi hijau berarti provider-nya sudah terpasang. Kami memvalidasi alur persis ini terhadap aplikasi web Chatbox terkini, dan dialog yang sama dirilis di build desktop dan mobile.

Bagaimana Chatbox berbicara dengan provider kustom.

Chatbox (chatboxai di GitHub, sekitar 41K bintang) adalah salah satu client chat AI paling banyak diinstal: aplikasi native untuk Windows, macOS, dan Linux, build mobile untuk iOS dan Android, dan versi browser di web.chatboxai.app. Ia dirilis dengan entri first-party untuk vendor besar, masing-masing ingin key sendiri, dan dialog provider kustom adalah jalur terdokumentasi untuk semua yang lain. Provider kustom dalam mode OpenAI API Compatible adalah deskripsi sederhana dari endpoint: host, path, key, dan daftar id model. Setiap giliran percakapan menjadi request chat-completions standar terhadap host itu, dengan id model dari picker berjalan sebagai string. Chatbox tidak peduli vendor mana yang melatih model di balik suatu id, yang persis membuat gateway multi-vendor berguna di sini: satu entri provider menempatkan claude-sonnet-4-6, gpt-5.5, gemini-3.5-flash, dan deepseek-v4-flash di picker yang sama, ditagih melalui key yang sama. Perbedaan praktis dari menumpuk empat provider first-party bukan hanya lebih sedikit key. Pengaturan Chatbox sinkron per perangkat, jadi setiap akun vendor yang Anda tambahkan adalah key lain yang harus ditempel ke ponsel Anda, laptop Anda, dan aplikasi web. Satu provider kustom adalah satu tempel per perangkat, dan mengalihkan percakapan dari Claude ke DeepSeek adalah perubahan picker alih-alih perubahan provider.

Setup lengkap: setiap field di dialog.

Name hanyalah label; APIsRouter menjaga picker tetap terbaca. API Mode harus OpenAI API Compatible, yang memberi tahu Chatbox untuk berbicara chat completions standar; mode lain di dropdown untuk endpoint native-Gemini dan bukan yang diinginkan gateway. API Host dan API Path tersusun menjadi URL request, dan pasangan ini adalah tempat setup sering salah. Dengan host diatur ke https://api.apisrouter.com/v1, path-nya adalah /chat/completions, dan Chatbox mengisi persis itu saat mengenali host /v1. Dokumentasi Chatbox juga menjelaskan konvensi host-telanjang, di mana host mengabaikan /v1 dan path default ke /v1/chat/completions; keduanya tersusun ke URL yang sama, jadi pilih satu bentuk dan biarkan field lain pada default-nya. Yang rusak adalah mencampur keduanya, host /v1 dengan path /v1/chat/completions, yang menghasilkan URL /v1/v1 ganda yang 404. Label field dan perilaku autofill bergeser sedikit antar rilis Chatbox, jadi percayai URL yang tersusun daripada ingatan. Untuk model, Fetch adalah jalur low-effort: Chatbox mendaftar semua yang dilayani endpoint dan Anda mengaktifkan yang Anda inginkan. New adalah jalur terkurasi: ketik id dengan tangan dan picker-nya tetap singkat. Setiap baris model punya sakelar kapabilitas (visi, penggunaan tool); biarkan mati kecuali Anda tahu model mendukung kapabilitas itu, karena model yang tidak dikonfigurasi diperlakukan sebagai teks biasa dan itu default yang aman. Selesaikan dengan Check, lalu mulai percakapan dan pilih model di bawah nama provider baru Anda.

Name:      APIsRouter
API Mode:  OpenAI API Compatible
API Key:   sk-YOUR-APISROUTER-KEY
API Host:  https://api.apisrouter.com/v1
API Path:  /chat/completions   (terisi otomatis)

Models: Fetch (tarik katalog) atau New (ketik id)
Lalu:   Check → konfirmasi hijau

Memilih model untuk client chat harian.

Karena setiap model yang diaktifkan ditagih melalui satu key, membandingkan dua id adalah pergantian picker alih-alih keputusan akun. Jalankan jenis percakapan yang sama pada keduanya selama beberapa hari, lalu baca pengeluaran per model di konsol APIsRouter dan pertahankan yang layak mendapat tempatnya.

  • Pertanyaan sehari-hari dan penulisan ulang cepat adalah kerja burst. claude-haiku-4-5-20251001 dan gemini-3.5-flash menjawab cukup cepat sehingga app terasa instan, dan mereka mengangkut sebagian besar traffic harian dengan baik.
  • Penyusunan draf panjang, reasoning hati-hati, dan diskusi kode pantas mendapat claude-sonnet-4-6 atau gpt-5.5. Jaga satu dari setiap tier tetap aktif dan tukar per percakapan alih-alih per provider.
  • deepseek-v4-flash adalah pilihan volume jika Chatbox adalah sidebar Anda yang selalu terbuka; percakapan kecil yang konstan menumpuk dan tier cepat menjaga saldo bergerak lambat.
  • Percakapan dengan input gambar butuh id yang mendukung visi dengan sakelar visi diaktifkan di baris model itu; konfirmasi kapabilitas terhadap dokumentasi model sebelum menyalakan sakelarnya.
  • Aktifkan sedikit model dengan sengaja alih-alih mengambil semuanya: setiap toggle adalah baris picker, dan menambahkan id lagi belakangan adalah editan sepuluh detik.

Bayar sesuai pemakaian · di bawah harga resmi

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

ModelHarga ResmiHarga Kami
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
Claude Haiku 4.5 20251001$1.00 / $5.00 per M$0.80 / $4.00 per M
GPT-5.5$5.00 / $30.00 per M$4.00 / $24.00 per M
Gemini 3.5 Flash$1.50 / $9.00 per M$1.20 / $7.20 per M
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M

Mode kegagalan spesifik Chatbox.

Path ganda adalah klasiknya. 404 pada setiap pesan berarti API Host dan API Path keduanya membawa /v1 atau path-nya mengulang apa yang sudah diakhiri host; buka entri provider dan baca dua field itu sebagai satu URL. Hasil kosong dari Fetch biasanya berarti key-nya salah atau hilang, karena listing model itu sendiri adalah request yang diautentikasi. Cek field API Key dan gunakan tombol Check, yang menampilkan error autentikasi secara langsung. Model yang error hanya di beberapa percakapan biasanya sakelar kapabilitas: visi diaktifkan pada model yang tidak punya input gambar, atau alur bergantung-tool mengenai model dengan tool dimatikan. Reset baris model ke default dan aktifkan kapabilitas satu per satu. Dan ingat entri provider hidup per instalasi. Menambahkan APIsRouter di desktop Anda tidak mengonfigurasi ponsel Anda; ulangi dialognya di sana, atau gunakan fitur berbagi konfigurasi Chatbox sendiri jika versi Anda menawarkannya. Satu hal yang tidak pernah perlu diulang adalah sign-up vendor, karena satu key mencakup setiap model pada setiap perangkat.

Siapa yang merutekan Chatbox melalui gateway.

  • Orang yang ingin Claude, GPT, Gemini, dan DeepSeek di satu picker tanpa memelihara empat akun vendor dan empat key di tiga perangkat.
  • Pengguna di region di mana beberapa sign-up vendor menyakitkan; akses berbasis top-up tanpa syarat kartu menghilangkan ketergantungan per provider.
  • Developer yang sudah merutekan editor dan tool terminal mereka melalui gateway dan ingin client chat mereka pada key dan log penggunaan yang sama.
  • Model shopper yang membandingkan id pada percakapan nyata sebelum berkomitmen pada satu proyek; setiap kandidat adalah baris picker, bukan akun.
  • Rumah tangga dan tim kecil yang menstandarkan satu endpoint, satu saldo, dan visibilitas penggunaan per-key alih-alih langganan yang berserakan.

Verifikasi endpoint dan debug pesan pertama.

Buktikan separuh gateway di luar Chatbox dulu: daftar model dengan key Anda, lalu jalankan satu chat completion terhadap id yang Anda rencanakan aktifkan. Jika keduanya lolos, semua yang tersisa ada di dialog provider. Di dalam Chatbox, tombol Check adalah sinyal tercepat. Error autentikasi adalah field key. Error not-found saat mengirim adalah ketidakcocokan id, yang paling sering terjadi dengan entri New yang diketik tangan; salin id dari output /v1/models alih-alih dari ingatan. 404 pada setiap request adalah komposisi host/path yang dibahas di atas. Setelah pesan mengalir, konsol APIsRouter menunjukkan model per request, hitungan token, dan pengeluaran. Client chat menghasilkan banyak request kecil sepanjang hari, dan log penggunaan adalah tempat kebiasaan itu menjadi angka per model, per hari yang benar-benar bisa Anda baca.

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"}]}'

Pertanyaan umum

Bagaimana cara menambah API host kustom ke Chatbox?

Settings, tab Model Provider, Add, lalu Add Custom Provider. Atur API Mode ke OpenAI API Compatible, API Host ke https://api.apisrouter.com/v1, tempel key Anda, dan biarkan API Path pada default /chat/completions-nya. Tambahkan model dengan Fetch atau New, lalu tekan Check.

Haruskah API Host menyertakan /v1?

Kedua bentuk berfungsi selama host dan path tersusun ke /v1/chat/completions tepat sekali. Dengan host https://api.apisrouter.com/v1 path-nya adalah /chat/completions; dengan host telanjang path-nya default ke /v1/chat/completions. Mencampur keduanya menggandakan /v1 dan 404.

Bisakah Chatbox menjalankan Claude, Gemini, dan DeepSeek melalui satu entri provider?

Ya. Dalam mode OpenAI API Compatible, id model berjalan ke API Host sebagai string biasa, jadi satu entri bisa mengaktifkan claude-sonnet-4-6, gemini-3.5-flash, dan deepseek-v4-flash bersama, semua ditagih melalui key yang sama dan bisa ditukar di picker.

Mengapa Fetch tidak mengembalikan model?

Fetch memanggil listing /v1/models endpoint dengan key Anda, jadi hasil kosong hampir selalu masalah autentikasi. Cek ulang field API Key dan jalankan tombol Check; setelah key-nya lolos, Fetch mendaftar setiap id yang dilayani gateway.

Apakah provider kustom juga berfungsi di Chatbox mobile dan web?

Ya, dialog Add Custom Provider dirilis di build desktop, mobile, dan web. Entri provider dikonfigurasi per instalasi, jadi ulangi setup satu-dialog di setiap perangkat dengan key yang sama.

Apakah saya perlu sakelar kapabilitas di setiap model?

Tidak. Model yang tidak dikonfigurasi berfungsi sebagai chat teks biasa, yang merupakan default yang aman. Aktifkan sakelar visi atau tool hanya pada model yang benar-benar mendukung kapabilitas itu, karena sakelar yang salah diaktifkan menghasilkan error membingungkan tepat di percakapan yang menggunakannya.