POST /v1/chat/completions

Rute teks utama. Bentuk body request mengikuti skema OpenAI Chat Completions, jadi klien OpenAI yang sudah ada langsung bekerja begitu base URL dan key-nya diganti.

curl https://api.botconnector.id/v1/chat/completions \
  -H "Authorization: Bearer bc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"model":"ling-3.0-flash-sante","messages":[{"role":"user","content":"Halo"}]}'

python

from openai import OpenAI
import os

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

response = client.chat.completions.create(
    model="ling-3.0-flash-sante",
    messages=[{"role": "user", "content": "Halo"}],
)

print(response.choices[0].message.content)

Model ID

Ambil nilai model dari GET /v1/models. ID yang tidak ada di daftar akun Anda tidak bisa dipanggil, meskipun halaman katalog menampilkannya untuk paket lain.

Streaming

Tambahkan "stream": true untuk menerima jawaban sebagai aliran event, bukan satu objek response. SDK menanganinya sama seperti pada OpenAI:

python

stream = client.chat.completions.create(
    model="ling-3.0-flash-sante",
    messages=[{"role": "user", "content": "Hitung sampai lima"}],
    stream=True,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="")

Bila request ditolak

Bentuk request yang belum didukung menghasilkan error eksplisit, bukan diam-diam dialihkan ke provider lain, jadi kegagalan di log Anda selalu berarti apa adanya. Periksa dulu nilai model terhadap GET /v1/models; itu penyebab yang paling sering.

Permukaan lain

Anthropic Messages dan OpenAI Responses native tersedia di rute terpisah. Lihat tabel rute untuk kontrak publik yang berlaku, atau referensi API untuk parameternya.