Masalah API

Connection refused

1. Apakah server berjalan? botconnector server status
2. Mulai: botconnector server start (botconnector server)
3. Konfirmasi port: default 11435 — --port kustom mengubah semua URL.

404 pada model

Field model harus sama dengan id model yang dimuat:

botconnector ps --json

Gunakan persis id itu dalam permintaan. Model yang diunduh tapi belum dimuat tidak dilayani.

401 / error otorisasi

• --api-key diatur saat server start; kirim Authorization: Bearer <key> — Autentikasi.
• Key dirotasi? Perbarui semua klien.

Port salah / proses usang

• botconnector ps menampilkan apa yang benar-benar berjalan.
• Instance sebelumnya mungkin memegang port — hentikan atau pakai port lain dan perbarui klien.

Gagal dari perangkat lain

Localhost hanya mengikat mesin ini. Akses remote membutuhkan binding + auth eksplisit — lihat Pengikatan jaringan dan Remote.

Respons rusak / menggantung

• Verifikasi dengan permintaan mentah:

curl http://127.0.0.1:11435/v1/models

• Jika curl bekerja tapi klien gagal, base URL klien kemungkinan salah (kehilangan /v1 adalah error paling umum).
• Klien streaming: pastikan penanganan SSE — Streaming.