Autentikasi

Setiap request ke Hosted Developer API diautentikasi dengan API key milik akun BotConnector Anda.

Membuat key

Buka Workspace → API Keys lalu buat key. Simpan di secret manager, bukan di dokumen atau pesan chat.

Key yang dibuat di sana diawali bc_live_. Sisa string-nya adalah rahasianya.

Mengirimnya

Sertakan key sebagai Bearer token pada setiap request:

Authorization: Bearer bc_live_...

Request tanpa key yang sah akan mengembalikan error autentikasi. Tidak ada tier anonim dan tidak ada alternatif lewat query string — header ini satu-satunya bentuk yang diterima.

Dari SDK OpenAI

API hosted ini kompatibel dengan OpenAI, jadi SDK hanya perlu base URL dan key:

python

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://api.botconnector.id/v1",
    api_key=os.environ["BOTCONNECTOR_API_KEY"],
)

print(client.models.list())

javascript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.botconnector.id/v1",
  apiKey: process.env.BOTCONNECTOR_API_KEY,
});

console.log(await client.models.list());

Mengelola key

Key dapat dibuat, dilihat, dan dicabut dari Workspace.

Simpan key di sisi server. Jangan menaruhnya di kode client-side, bundel aplikasi mobile, atau repositori publik, dan jangan menempelkannya ke pesan dukungan. Bila key bocor, cabut di Workspace lalu buat penggantinya.

Selanjutnya

GET /v1/models — daftar Model ID yang bisa dipakai akun Anda.
POST /v1/chat/completions — kirim request chat.