Dokumentasi — BM3 AI

Mulai cepat

Masuk dengan Google — akun otomatis dibuat.
Isi saldo kredit (lihat Saldo & tagihan).
Buat API key di Console → API Key.
Kirim request ke base URL di bawah.

base_url

https://bm3ai.smartbm3.com/v1

Autentikasi

Kirim API key di header Authorization. Header x-api-key juga diterima.

Authorization: Bearer sk-bm3-xxxxxxxx

Simpan API key di server / environment variable. Jangan menaruhnya di kode frontend atau repositori publik.

Model

Pakai ID model persis seperti tertulis. Daftar lengkap ada di halaman Model atau lewat API (tanpa key):

bash

curl https://bm3ai.smartbm3.com/v1/models

ID model	Nama	Tarif / 1M token
bm/deepseek-v4.1-flash	DeepSeek V4.1 Flash	0,3 kredit

Chat completions

POST /v1/chat/completions — field wajib: model dan messages.

curl https://bm3ai.smartbm3.com/v1/chat/completions \
  -H "Authorization: Bearer sk-bm3-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bm/deepseek-v4.1-flash",
    "messages": [{ "role": "user", "content": "Halo!" }],
    "stream": true
  }'

Parameter yang umum dipakai

Field	Tipe	Keterangan
`model`	string	Wajib. ID model dari katalog.
`messages`	array	Wajib. Objek `role` (system/user/assistant) + `content`.
`stream`	boolean	`true` untuk jawaban bertahap (SSE).
`temperature`	number	0–2. Makin tinggi makin variatif.
`max_tokens`	number	Batas panjang jawaban.
`tools`	array	Function calling, bila didukung model.

Streaming

Dengan stream: true, jawaban dikirim sebagai Server-Sent Events dan diakhiri data: [DONE]. Tambahkan "stream_options": {"include_usage": true} untuk menerima jumlah token di chunk terakhir.

contoh chunk

data: {"id":"chatcmpl-…","object":"chat.completion.chunk","model":"bm/deepseek-v4.1-flash","choices":[{"index":0,"delta":{"content":"Halo"}}]}

data: [DONE]

Editor & agen

Semua tool yang mendukung “OpenAI-compatible / custom base URL” bisa langsung dipakai.

// Cursor → Settings → Models
// 1. Isi "OpenAI API Key"      : sk-bm3-xxxxxxxx
// 2. Nyalakan "Override OpenAI Base URL"
//    Base URL                  : https://bm3ai.smartbm3.com/v1
// 3. Tambah model dengan ID    : bm/deepseek-v4.1-flash
// Selesai — pilih model itu di Chat / Composer.

Saldo & tagihan

Setiap request memotong saldo: (token input × tarif input + token output × tarif output) ÷ 1.000.000.
Rincian per request (token, biaya, latensi) ada di Console → Pemakaian.
Isi saldo saat ini manual lewat admin — halo@smartbm3.com. Sertakan email akun Anda.
Setiap key bisa diberi batas token sendiri, berguna untuk membagi key ke tim / aplikasi berbeda.

Kode error

Format error mengikuti OpenAI. Setiap response membawa header x-request-id — sertakan saat melapor masalah.

{
  "error": {
    "message": "Saldo kredit habis. Isi saldo di console untuk melanjutkan.",
    "type": "insufficient_quota",
    "code": "insufficient_quota",
    "param": null
  }
}

Status	Code	Artinya
400	`invalid_request`	Body atau parameter tidak valid.
401	`invalid_api_key`	API key salah, dinonaktifkan, atau tidak dikirim.
402	`insufficient_quota`	Saldo kredit habis.
403	`account_disabled`	Akun pemilik key dinonaktifkan.
404	`model_not_found`	ID model tidak ada di katalog.
429	`rate_limit_exceeded`	Terlalu banyak request per menit.
429	`key_limit_reached`	Batas token key ini tercapai.
503	`service_unavailable`	Gangguan sementara, coba lagi.

Batasan

Default 60 request / menit per key (bisa dinaikkan, hubungi admin).
Konteks & output maksimum mengikuti tiap model — lihat halaman Model.
Isi percakapan tidak disimpan; hanya metadata pemakaian.

Bantuan

Email halo@smartbm3.com. Sertakan x-request-id bila melaporkan error.

Integrasi dalam 2 menit.