Mulai Menggunakan API
import { Card, CardGrid, Steps, Aside, Tabs, TabItem, LinkButton } from ‘starlight/components’;
Satu baseURL, satu API key, langsung streaming. Tanpa kartu kredit.
Base URL
Model dipakai dengan slug bt/nama-model (mis. bt/qwen3.8-flash).
3 langkah — 60 detik
-
Daftar & ambil key — buka console.balitechsolution.com/register, buat akun (gratis, tanpa kartu kredit), lalu ke menu API Keys dan copy key
sk-db-.... -
Ganti
baseURL— di kode/SDK yang sudah pakai format OpenAI, cukup arahkan ke gateway:baseURL: "https://api.openai.com/v1"baseURL: "https://balitechsolution.com/v3" -
Kirim request pertama:
Terminal window curl https://balitechsolution.com/v3/chat/completions \-H "Authorization: Bearer sk-db-ISI_KEY_KAMU" \-H "Content-Type: application/json" \-d '{"model":"bt/qwen3.8-flash","messages":[{"role":"user","content":"Halo!"}]}'Balasan
200 OK+ streamdata: {...}berarti setup beres.
Pengaturan untuk OpenCode, Hermes, dan Kilo Code
Pilih tab sesuai tool kamu. Semua butuh 3 nilai yang sama: baseURL https://balitechsolution.com/v3, apiKey sk-db-..., model bt/....
2. **Paste config ini** (ganti `sk-db-...` dengan key kamu):
```json{ "$schema": "https://opencode.ai/config.json", "model": "balitech-v3/bt/sonnet4.5", "small_model": "balitech-v3/bt/qwen3.8-flash", "provider": { "balitech-v3": { "npm": "@ai-sdk/openai-compatible", "options": { "baseURL": "https://balitechsolution.com/v3", "apiKey": "sk-db-..." }, "discoverModels": true } }}```
3. **Verifikasi** — `discoverModels: true` mengambil daftar model otomatis dari `GET /v3/models`:
```bashnpx opencode models | grep balitech# balitech-v3/bt/sonnet4.5# balitech-v3/bt/qwen3.8-flash
npx opencode run -m balitech-v3/bt/qwen3.8-flash "Halo v3!"```
Model tidak muncul? Cek: `baseURL` tanpa `/` di akhir, key diawali `sk-db-`, dan file JSON valid (`python3 -m json.tool opencode.json`).1. **Daftarkan provider Balitech:**
```bashhermes config set model.provider customhermes config set model.base_url https://balitechsolution.com/v3hermes config set model.default bt/qwen3.8-flash```
2. **Simpan API key** sebagai environment variable (nama ini yang dibaca Hermes untuk base URL Balitech):
```bashexport HERMES_CUSTOM_BALITECHSOLUTION_COM_API_KEY="sk-db-ISI_KEY_KAMU"echo 'export HERMES_CUSTOM_BALITECHSOLUTION_COM_API_KEY="sk-db-ISI_KEY_KAMU"' >> ~/.bashrc```
3. **Verifikasi** — refresh daftar model lalu kirim satu pesan:
```bashhermes model --refreshhermes -z "Halo Hermes!"```1. Buka **Settings** (ikon gear) → tab **Providers** → scroll ke bawah → **Custom provider**.
2. Isi dialog persis seperti ini:
| Field | Isi ||-------|-----|| Provider ID | `balitech-v3` || Display name | `BaliTech v3` || Provider API | `OpenAI Compatible` || Base URL | `https://balitechsolution.com/v3` || API key | `sk-db-ISI_KEY_KAMU` |
3. Klik **Submit**. Kilo otomatis membaca `GET /v3/models` dan menampilkan semua model `bt/...` di model picker — ketik mis. `sonnet` lalu pilih `bt/sonnet4.5`.
4. **Verifikasi:** buka chat Kilo, pilih model `BaliTech v3 / bt/qwen3.8-flash`, kirim `Halo!`.
Error `Invalid API Key` → key salah/expired, cek di console. `Model Not Found` → pakai ID persis dari picker (`bt/...`, bukan nama display).Ganti model default
| Pakai | model | small_model |
|---|---|---|
| v3 | balitech-v3/bt/sonnet4.5 | balitech-v3/bt/qwen3.8-flash |
Kalau balas 503 server_busy, retry dengan backoff. Katalog lengkap ada di Models.
Test request
Referensi quota & settings: Settings API. Butuh batch, audio, atau streaming? Lanjut ke Chat Completions dan Streaming.