Lompat ke konten
Dokumentasi API BaliTech

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.

API key diperlukan untuk request Buat key di console, simpan sebagai secret, lalu pakai header Authorization: Bearer sk-db-....
Buat key

Quickstart

Kirim request pertama

Tiga langkah: buat key, arahkan client ke gateway, lalu kirim request dengan model ID dari katalog.

  1. 01

    Buat API key

    Daftar di Console, buka API Keys, dan copy key yang hanya ditampilkan satu kali.

  2. 02

    Set base URL

    Gunakan https://balitechsolution.com/v3 sebagai endpoint OpenAI-compatible.

  3. 03

    Kirim request

    Pilih model dengan format bt/nama-model dan 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!"}]
  }'

Katalog model

Model yang tersedia

Gunakan ID model pada kolom pertama. Katalog publik mengikuti model aktif dan harga yang tersedia.

Model IDStatusInputFamily
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.

01 / CREATE

Buat key

Login ke Console, buka API Keys, lalu buat key baru.

02 / HEADER

Kirim Bearer

Sertakan Authorization: Bearer sk_... di setiap request.

03 / MONITOR

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

ParameterJenisKeterangan
modelstringID model, contoh bt/qwen3.8-flash.
messagesarrayRiwayat dengan role system, user, atau assistant.
streambooleanOpsional. Jika true, response dikirim sebagai SSE.
temperaturenumberOpsional. Nilai kreativitas 0 sampai 2.
max_tokensintegerOpsional. Batas maksimum token output.

Streaming

Tampilkan jawaban bertahap

Set stream: true untuk menerima token secara bertahap.

curl · Server-Sent Events
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.

MetodePathFungsi
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.

OpenCode · opencode.json
{
  "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.

StatusKodeArti / 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.

Siap mencoba?

Buat API key, pilih model, dan kirim request pertamamu sekarang.

Buat akun gratis →