Dokumentasi API

Mulai dalam
lima menit.

Panglima Router mengikuti format OpenAI. Kalau kodemu sudah memakai OpenAI SDK, ganti base URL dan API key, lalu pilih model dari katalog.

Autentikasi

Buat API key dari menu bot Telegram@panglimarouter_botsetelah paket aktif. Kirim key di headerAuthorization. Key tampil sekali saja, simpan di tempat aman.

Authorization: BearerPR-KEY-KAMU

Base URL

https://api.panglimarouter.xyz/v1

GET /v1/models

Daftar model yang aktif untuk akunmu. Tidak perlu auth tambahan selain API key.

curlhttps://api.panglimarouter.xyz/v1/models \ -H"Authorization: Bearer PR-KEY-KAMU"

POST /v1/chat/completions

Chat completions. Request dan response mengikuti format OpenAI. Isimodeldengan ID dari/v1/models.

cURLPythonNode.js
curlhttps://api.panglimarouter.xyz/v1/chat/completions \ -H"Authorization: Bearer PR-KEY-KAMU"\ -H"Content-Type: application/json"\ -d'{"model": "MODEL_ID", "messages": [{"role": "user", "content": "Halo!"}]}'

Streaming

Tambahkan"stream": trueuntuk menerima token secara bertahap, sama seperti OpenAI.

forchunkinclient.chat.completions.create(model="MODEL_ID", messages=msgs, stream=True):print(chunk.choices[0].delta.contentor"", end="")

Bantuan

Pertanyaan teknis? Gabunggrup diskusiatau pantauhalaman status.

Billing dan saldo

Saldo dalam Rupiah (IDR). Setiap request mereservasi saldo secara atomik sebelum dikirim ke penyedia, lalu di-settle sesuai pemakaian token aktual. Saldo tidak akan pernah negatif.

Tagihan dihitung dari token input dan output dikali tarif model yang dipakai. Jika saldo tidak cukup untuk estimasi biaya, request ditolak sebelum dikirim ke penyedia (HTTP 402). Reservasi yang tidak terpakai dikembalikan otomatis. Kirim header Idempotency-Key unik untuk operasi berbayar agar retry aman dari double-charge.

Top-up saldo

Isi saldo via QRIS atau crypto (USDC di jaringan Base), minimum Rp10.000 per top-up. Saldo masuk setelah pembayaran terverifikasi.

Dari dashboard, pilih nominal top-up dan metode (QRIS atau crypto). Untuk QRIS: pindai kode QR yang tampil dan bayar sebelum kedaluwarsa. Untuk crypto: kirim USDC tepat ke alamat yang tampil di jaringan Base. Setiap pembayaran diverifikasi via callback bertanda tangan dengan proteksi replay dan idempotency.

Paket unlimited

Paket harian, mingguan, dan bulanan untuk model tertentu tanpa tagihan per-request selama masa aktif, dengan batas fair-use (RPM dan konkurensi). Paket terpisah dari saldo metered: selama paket aktif dan model termasuk, request tidak memotong saldo. Status, masa berlaku, dan pemakaian paket tercatat dan dapat dilihat di dashboard.

Akses bansos

Bansos adalah akses AI gratis untuk pengguna terdaftar, lewat endpoint khusus yang terpisah penuh dari endpoint berbayar, dan tidak akan pernah beralih diam-diam ke tagihan berbayar. Gunakan POST /v1/bansos/chat/completions (bukan /v1/chat/completions). Format request/response kompatibel OpenAI, sama seperti endpoint berbayar.

Akses ditentukan oleh entitlement bansos aktif Anda, bukan saldo atau paket unlimited. Hanya model yang diizinkan program bansos yang dapat dipakai. Selama entitlement aktif, tidak ada batas total request/token. Yang berlaku: masa berlaku, batas requests-per-minute, batas konkurensi, dan proteksi penyalahgunaan. Request bansos tidak pernah menyentuh saldo atau paket berbayar. Respons menyertakan header x-billing-mode: bansos. Error khusus: 403 model-not-included jika model tidak termasuk entitlement bansos Anda. Ajukan dan pantau status di halaman bansos.

Error dan batas

Error memakai format JSON OpenAI. Kode umum: 400 (request tidak valid), 401 (API key salah), 402 (saldo kurang), 404 (model tidak tersedia), 429 (rate limit), 502/503 (penyedia bermasalah). Selalu sertakan x-request-id dari respons saat menghubungi dukungan. Batas ukuran request 1MB dan timeout 30 detik per request.