Cara Menghubungkan 9router ke Inferouter: Panduan untuk User
Cara Menghubungkan 9router ke Inferouter
Panduan ini ditujukan untuk user Inferouter yang ingin memakai 9router sebagai client atau router lokal dengan endpoint Inferouter.
Anda tidak perlu mengatur provider upstream, database, atau custom route admin. Yang dibutuhkan hanya:
- Base URL Inferouter.
- API key Inferouter milik Anda.
- Nama model yang tersedia di Inferouter.
- Aplikasi 9router yang mendukung OpenAI-compatible API.
Cara kerja koneksi
Aplikasi / 9router
|
v
Inferouter API
|
v
Model provider
Di konfigurasi 9router, Inferouter dipasang sebagai OpenAI-compatible provider. API key provider tetap dikelola oleh Inferouter dan tidak perlu dimasukkan ke perangkat Anda.
Data yang perlu disiapkan
Gunakan nilai berikut:
| Pengaturan | Nilai |
|---|---|
| Base URL | https://inferouter.my.id/v1 |
| API key | API key Inferouter Anda |
| Model | Salah satu model dari /v1/models |
| Format API | OpenAI-compatible |
Jangan membagikan API key Inferouter di screenshot, Git, forum, atau artikel publik.
Langkah 1 - Dapatkan API key Inferouter
- Buka Client Area Inferouter.
- Login ke akun Anda.
- Buka bagian API Keys.
- Buat atau salin API key untuk perangkat yang akan dipakai.
Simpan key di password manager atau secret manager. Jangan memasukkannya ke source code yang akan dipush ke repository.
Langkah 2 - Cek model yang tersedia
Sebelum memasukkan model ke 9router, cek katalog model Inferouter:
curl -sS https://inferouter.my.id/v1/models \
-H "Authorization: Bearer INFEROUTER_API_KEY"
Ganti INFEROUTER_API_KEY dengan key Anda secara lokal. Jangan menaruh key asli di command yang tersimpan di history shell jika environment variable bisa digunakan.
Contoh model yang dapat muncul di katalog:
step-3.7-flash
deepseek-v4-pro
mimo-v2.5
glm-4.5-flash
glm-4.6v
Gunakan ID model persis seperti yang muncul di response /v1/models.
Langkah 3 - Tambahkan Inferouter di 9router
Buka pengaturan provider di 9router, lalu pilih provider dengan format OpenAI-compatible atau Custom OpenAI.
Isi konfigurasi:
Provider name: Inferouter
Base URL: https://inferouter.my.id/v1
API key: API key Inferouter Anda
Jika 9router meminta endpoint lengkap, gunakan:
https://inferouter.my.id/v1/chat/completions
Namun jika tersedia field Base URL, gunakan URL tanpa /chat/completions:
https://inferouter.my.id/v1
Langkah 4 - Pilih model
Pilih salah satu model yang tampil di /v1/models.
Contoh:
Model: deepseek-v4-pro
Untuk pengujian awal, gunakan prompt pendek dan output kecil. Setelah berhasil, Anda dapat menaikkan batas output sesuai kebutuhan.
Langkah 5 - Test request dengan curl
Sebelum menguji dari interface 9router, Anda dapat menguji endpoint secara langsung:
export INFEROUTER_API_KEY='isi_key_di_environment_lokal'
curl -sS https://inferouter.my.id/v1/chat/completions \
-H "Authorization: Bearer $INFEROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-pro",
"messages": [
{"role": "user", "content": "Halo, balas dengan satu kalimat."}
],
"max_tokens": 32
}'
Response yang berhasil biasanya memiliki choices dan pesan assistant.
Langkah 6 - Contoh konfigurasi OpenAI-compatible
Jika 9router memakai format environment variable, gunakan pola berikut:
OPENAI_BASE_URL=https://inferouter.my.id/v1
OPENAI_API_KEY=isi_key_inferouter_di_environment
OPENAI_MODEL=deepseek-v4-pro
Nama variable dapat berbeda di tiap versi 9router. Prinsipnya tetap sama:
base_url = https://inferouter.my.id/v1
api_key = API key Inferouter
model = model dari /v1/models
Langkah 7 - Jika memakai OpenCode atau client lain
Pada client yang meminta konfigurasi provider custom, isi:
{
"baseURL": "https://inferouter.my.id/v1",
"apiKey": "INFEROUTER_API_KEY",
"model": "deepseek-v4-pro"
}
Gunakan nama field sesuai dokumentasi client Anda. Jangan mengubah baseURL menjadi URL provider upstream karena tujuan konfigurasi adalah melewatkan traffic melalui Inferouter.
Troubleshooting
401 Unauthorized
API key tidak valid, sudah direvoke, atau format header salah. Pastikan request memakai:
Authorization: Bearer API_KEY
403 This model is not enabled on the gateway
Nama model tidak sama dengan model yang tersedia. Jalankan kembali /v1/models, lalu copy nilai id secara persis.
404 Not Found
Periksa Base URL. Untuk OpenAI-compatible client, gunakan:
https://inferouter.my.id/v1
Jangan menggandakan path menjadi /v1/v1.
422 Model not found
Model tidak dikenali oleh route yang sedang aktif. Pilih model lain dari /v1/models atau tunggu sampai route provider kembali tersedia.
429 Rate limit
Tunggu sebentar, kurangi concurrency, atau cek quota akun. Jangan langsung mengirim retry paralel dalam jumlah besar.
Request berhasil tetapi live stats belum berubah
Pastikan request benar-benar memakai Base URL Inferouter, bukan endpoint 9router/provider langsung. Hanya request yang melewati:
https://inferouter.my.id/v1
yang akan tercatat di usage Inferouter.
Checklist user
- [ ] Sudah memiliki API key Inferouter.
- [ ] Base URL 9router diarahkan ke
https://inferouter.my.id/v1. - [ ] API key dimasukkan sebagai Bearer token.
- [ ] Model berasal dari response
/v1/models. - [ ] Test request mendapatkan response assistant.
- [ ] Usage muncul di live stats Inferouter.
- [ ] API key tidak tersimpan di source code atau screenshot.
Setelah konfigurasi selesai, semua request dari 9router akan memakai Inferouter sebagai gateway OpenAI-compatible Anda.
