BotConnector
EN

Referensi Developer API

Hosted Developer API: stable · public · verified

Base URL: https://api.botconnector.id/v1

Autentikasi

Authorization: Bearer bc_live_...

API key dibuat dan dicabut dari Workspace.

GET /v1/models

Mengembalikan Model ID yang tersedia untuk akun terautentikasi. Request tanpa key yang valid menghasilkan error autentikasi.

POST /v1/chat/completions

Permukaan chat-completions kompatibel OpenAI. Gunakan Model ID canonical dari GET /v1/models.

OpenAI Responses — GPT-6 Luna

GPT-6 Luna menggunakan native OpenAI Responses API pada jalur Web App/BCCLI untuk paket berbayar yang memenuhi syarat. Route Luna tidak dibuka sebagai route generik untuk API key biasa.

Yang sudah tersedia:

  • POST /v1/responses
  • WebSocket /v1/responses
  • POST /v1/responses/input_tokens
  • POST /v1/responses/compact
  • GET /v1/responses/{response_id}
  • DELETE /v1/responses/{response_id}
  • POST /v1/responses/{response_id}/cancel
  • GET /v1/responses/{response_id}/input_items
  • POST /v1/conversations
  • GET|POST|DELETE /v1/conversations/{conversation_id}
  • GET|POST /v1/conversations/{conversation_id}/items
  • GET|DELETE /v1/conversations/{conversation_id}/items/{item_id}

Responses mendukung native streaming, prompt caching, previous_response_id, WebSocket stream_id, mid-turn steering di proxy, automatic compaction untuk BCCLI, dan background retrieve/resume. Resource state divalidasi terhadap pemilik BotConnector sebelum diteruskan ke project OpenAI yang digunakan bersama.

Batas endpoint hosted

Belum menjadi bagian kontrak hosted publik:

  • OpenAI Files dan Vector Stores
  • OpenAI Embeddings
  • Rerank
  • OpenAI Audio, Realtime, dan GPT-Live
  • resource fine-tuning, Batch, dan administrasi OpenAI

Route yang belum didukung menghasilkan error eksplisit; tidak ada fallback diam-diam ke provider lain.

Permukaan akun

Workspace menyediakan pengelolaan API key, penggunaan, katalog model, panduan integrasi, dan status billing akun. Route internal akun/admin bukan bagian dari referensi publik ini.