Balian Blog · 28 September 2026 · 4 menit baca

OpenAI-Compatible API itu Apa, dan Kenapa Penting Buat Kamu?

Kalau kamu pernah baca dokumentasi provider AI, pasti sering lihat istilah "OpenAI-compatible" atau "format OpenAI". Sederhananya: format request/response API OpenAI (endpoint /v1/chat/completions) jadi standar de-facto industri. Hampir semua provider — dari DeepSeek sampai gateway lokal — memakai format yang sama persis, cuma beda base URL dan API key.

Anatomi Format OpenAI

Request-nya cuma terdiri dari beberapa elemen kunci:

POST /v1/chat/completions
Authorization: Bearer API_KEY_ANDA

{
  "model": "nama-model",
  "messages": [
    {"role": "user", "content": "Halo, apa itu API AI?"}
  ],
  "stream": false
}

Response-nya selalu punya struktur choices[0].message.content plus usage berisi hitungan token — itulah yang dipakai untuk billing per token.

Kenapa Ini Jadi Standar?

OpenAI datang pertama dan jadi rujukan. Semua tooling ekosistem — SDK resmi (Python/Node), LibreChat, Cursor, bot framework Discord/Telegram — dibuat mengarah ke format ini. Provider baru yang pakai format sama langsung bisa dipakai semua tool itu tanpa adapter tambahan. Efek jaringannya terlalu kuat buat dilawan, makanya "compatible" jadi fitur wajib.

Manfaat Praktis: Vendor Lock-in Nol

Karena formatnya identik, ganti provider = ganti dua konstanta:

Yang diganti	Contoh
`base_url`	`https://ai.balianapp.web.id/v1`
`api_key`	`balian-sk-...`

Model bisa diganti-ganti sesuai kebutuhan & budget — tugas ringan pakai balian/mini (Rp 3.000/1M token), coding berat pakai balian/deepseek-v4. Semua lewat satu integrasi.

Coba Sendiri dalam 2 Menit

curl https://ai.balianapp.web.id/v1/chat/completions \
  -H "Authorization: Bearer balian-sk-KEY_ANDA" \
  -H "Content-Type: application/json" \
  -d '{"model":"balian/mini","messages":[{"role":"user","content":"halo!"}]}'

Daftar di Balian AI, top-up pertama mulai Rp 5.000 via QRIS — cukup buat eksperimen serius.

Coba API-nya Sekarang — Mulai Rp 5.000 via QRIS →

← Semua artikel · Balian App