Hubungkan API AI dalam beberapa langkah.
BaliTech kompatibel dengan OpenAI API. Ganti baseURL, gunakan SDK resmi apa pun, lalu akses semua model dari satu endpoint.
Authorization: Bearer sk-db-.... Quickstart
Kirim request pertama
Tiga langkah: buat key, arahkan client ke gateway, lalu kirim request dengan model ID dari katalog.
- 01
Buat API key
Daftar di Console, buka API Keys, dan copy key yang hanya ditampilkan satu kali.
- 02
Set base URL
Gunakan
https://balitechsolution.com/v3sebagai endpoint OpenAI-compatible. - 03
Kirim request
Pilih model dengan format
bt/nama-modeldan mulai menerima response.
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!"}]
}' import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.BALITECH_API_KEY,
baseURL: "https://balitechsolution.com/v3"
});
const response = await client.chat.completions.create({
model: "bt/qwen3.8-flash",
messages: [{ role: "user", content: "Halo!" }]
});
console.log(response.choices[0].message.content); from openai import OpenAI
client = OpenAI(
api_key="sk-db-ISI_KEY_KAMU",
base_url="https://balitechsolution.com/v3"
)
response = client.chat.completions.create(
model="bt/qwen3.8-flash",
messages=[{"role": "user", "content": "Halo!"}]
)
print(response.choices[0].message.content) Katalog model
Model yang tersedia
Gunakan ID model pada kolom pertama. Katalog publik mengikuti model aktif dan harga yang tersedia.
| Model ID | Status | Input | Family |
|---|---|---|---|
| DeepSeek V4 Flashbt/deepseek-v4-flash | Premium | Text · Image | DeepSeek |
| DeepSeek V4 Probt/deepseek-v4-pro | Premium | Text · Image | DeepSeek |
| DeepSeek V4.1 Flashbt/deepseek-v4.1-flash | Premium | Text · Image | DeepSeek |
| GLM 5.3bt/glm-5.3 | Premium | Text · Image | GLM · Z.AI |
| GLM-5.3 Flashbt/glm-5.3-flash | Premium | Text · Image | GLM · Z.AI |
| GPT 6 Astrabt/gpt-6-astra | Premium | Text · Image | OpenAI |
| GPT 6 Solbt/gpt-6-sol | Premium | Text · Image | OpenAI |
| Grok 4.7bt/grok-4.7 | Premium | Text · Image | xAI · Grok |
| Kimi K2 5bt/kimi-k2.5 | Premium | Text · Image | Kimi |
| Kimi K3bt/kimi-k3 | Premium | Text · Image | Kimi |
| MiniMax M3.1 Flashbt/minimax-m3.1-flash | Premium | Text · Image | MiniMax |
| Minimax M3bt/minimax-m3 | Premium | Text · Image | MiniMax |
| Qwen 3.8 Flashbt/qwen3.8-flash | Premium | Text · Image | Qwen |
| Step 5 Previewbt/step-5-preview | Premium | Text · Image | Lainnya |
Katalog lewat API: GET https://balitechsolution.com/v3/models. Selalu gunakan ID resmi dari endpoint tersebut.
Keamanan API
API key dan autentikasi
Satu key bekerja untuk semua model. Jangan taruh key di URL, request body, repository publik, atau kode frontend.
Buat key
Login ke Console, buka API Keys, lalu buat key baru.
Kirim Bearer
Sertakan Authorization: Bearer sk_... di setiap request.
Lacak usage
Lihat token, biaya, model, dan status request di halaman Usage.
AuthorizationBearer sk-db-ISI_KEY_KAMU
Endpoint utama
Chat completions
POST /v3/chat/completions menerima body OpenAI-style. Parameter opsional mengikuti default model jika tidak dikirim.
POSThttps://balitechsolution.com/v3/chat/completions
| Parameter | Jenis | Keterangan |
|---|---|---|
| model | string | ID model, contoh bt/qwen3.8-flash. |
| messages | array | Riwayat dengan role system, user, atau assistant. |
| stream | boolean | Opsional. Jika true, response dikirim sebagai SSE. |
| temperature | number | Opsional. Nilai kreativitas 0 sampai 2. |
| max_tokens | integer | Opsional. Batas maksimum token output. |
Streaming
Tampilkan jawaban bertahap
Set stream: true untuk menerima token secara bertahap.
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":"Tulis puisi tiga baris."}],"stream":true}' SDK yang bisa dipakai
Gunakan SDK yang sudah dipakai
SDK resmi OpenAI untuk JavaScript dan Python dapat digunakan dengan mengganti baseURL dan apiKey.
JavaScript / TypeScript
npm install openai, lalu gunakan client OpenAI-compatible.
Python
pip install openai, lalu isi base_url saat membuat client.
Referensi
Daftar endpoint
Endpoint publik yang dapat dipanggil langsung dari aplikasi dengan API key.
| Metode | Path | Fungsi |
|---|---|---|
| POST | /v3/chat/completions | Generate response chat OpenAI-compatible. |
| GET | /v3/models | Ambil katalog model yang tersedia. |
| GET | /v3/usage | Ringkasan pemakaian dan token key. |
Coding agents
Hubungkan coding agent
Arahkan agent OpenAI-compatible ke base URL BaliTech, lalu simpan key di environment variable.
{
"model": "balitech-v3/bt/qwen3.8-flash",
"provider": {
"balitech-v3": {
"npm": "@ai-sdk/openai-compatible",
"name": "BaliTech",
"options": {
"baseURL": "https://balitechsolution.com/v3",
"apiKey": "{env:BALITECH_API_KEY}"
}
}
}
} Environment
export BALITECH_API_KEY="sk-db-..."
Jangan commit key ke repository.
Model check
Gunakan prefix bt/ dan cek daftar model lewat /v3/models.
Penanganan error
Format error
Error memakai format OpenAI dengan HTTP status dan error.code yang bisa dipakai untuk retry atau alerting.
| Status | Kode | Arti / langkah |
|---|---|---|
| 400 | validation_error | Body invalid atau messages kosong. Perbaiki request. |
| 401 | invalid_api_key | Key salah, revoked, atau header Bearer tidak ada. |
| 402 | insufficient_balance | Saldo tidak cukup. Top up melalui Wallet. |
| 404 | model_not_found | Model tidak ada di katalog. Cek GET /v3/models. |
| 429 | rate_limit | Terlalu banyak request. Tunggu sebelum retry. |
| 503 | upstream_busy | Provider sedang sibuk. Retry dengan backoff. |