Batas jaringan

BotConnector berbicara dengan tiga permukaan berbeda tergantung di mana model berjalan. Tertukar di antaranya adalah penyebab biasa request menggantung atau mendarat di layanan yang salah.

Cloud

Request cloud keluar dari mesin Anda lewat HTTPS ke satu host:

https://api.botconnector.id/v1

Itulah base URL untuk setiap rute hosted di bagian ini — models, chat completions, Messages, Responses. Tidak ada host kedua, tidak ada port alternatif, dan tidak ada endpoint HTTP biasa. Pasang sebagai base_url / baseURL pada SDK yang kompatibel dengan OpenAI, dan rute bawaan SDK akan sejajar dengannya.

Lokal, lewat CLI

CLI dan TUI publik menemukan runtime Ollama di antarmuka loopback:

http://localhost:11434
http://127.0.0.1:11434

Bila panggilan model lokal gagal sementara API hosted berjalan, periksa alamat itu lebih dulu: proses Ollama yang tidak berjalan, atau yang terikat di port berbeda, terlihat sama persis dari sisi klien.

Lokal, lewat BotConnector Core

Aplikasi desktop menjalankan runtime-nya sendiri — BotConnector Core — dan melayani API kompatibel OpenAI di port loopback yang berbeda:

http://127.0.0.1:11435/v1

Inilah permukaan yang dipakai runtime botconnector dan klien Python serta TypeScript preview; Core yang memegang pemuatan dan penyajian model. Ia permukaan preview, bukan bagian kontrak CLI npm publik, jadi CLI tidak memakainya: bccli menuju Ollama di 11434 atau ke API hosted.

Dua port loopback, dua proses berbeda. Bila Anda mengikuti halaman Python atau TypeScript, Anda ada di 11435 dan Core harus berjalan. Bila Anda mengikuti halaman CLI, Anda ada di 11434 atau di cloud.

Memilih

Pakai base URL cloud bila Anda menginginkan model hosted dari katalog dan tagihan per token. Pakai Core di 11435 bila Anda bekerja dengan runtime desktop dan SDK preview-nya. Pakai Ollama di 11434 bila model harus tetap di mesin dan Anda mengendalikannya dari CLI. Ketiganya base URL terpisah, bukan mode di dalam satu API.