CONSOLE // NODE_WORKSPACE

Dokumentasi & Spesifikasi API

Referensi integrasi endpoint OpenAI-compatible, format autentikasi, dan status operasional gateway.

Kembali ke Beranda

GATEWAY BASEURL (PRODUKSI)

https://koneva.asia/v1

Arahkan parameter baseURL SDK OpenAI atau AI client ke endpoint ini.

AUTHORIZATION HEADER

Authorization: Bearer kg_live_...

Gunakan API key aktif dari halaman API Keys.

MENGHUBUNGKAN KE CLINE, HERMES, OPENCODE, ATAU 9ROUTER?

Kami menyediakan panduan konfigurasi step-by-step & parameter siap salin untuk coding tools dan AI agents favorit Anda.

Buka Panduan AI Clients

CONTOH KODE SDK RESMI

cURL, Python, dan Node.js dengan parameter OpenAI standar.

SDK INTEGRATION

curl -X POST https://koneva.asia/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer kg_live_YOUR_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {
        "role": "system",
        "content": "Anda adalah asisten AI yang cerdas dan ringkas."
      },
      {
        "role": "user",
        "content": "Halo! Berikan 3 tips singkat untuk optimasi API."
      }
    ],
    "temperature": 0.7,
    "max_tokens": 500,
    "stream": false
  }'

POST /v1/chat/completions

ENDPOINT UTAMA INFERENCE DENGAN STRUKTUR RESPONS OPENAI

Parameter	Tipe	Wajib	Keterangan
model	string	Ya	ID model dari katalog aktif (contoh: deepseek-v4-flash).
messages	array	Ya	Daftar pesan role/content sesuai format OpenAI chat.
temperature	number	Opsional	Kontrol variasi output. Default mengikuti standar OpenAI.
max_tokens	integer	Opsional	Batas token output yang dihasilkan model.
stream	boolean	Opsional	Set false untuk respons batch.

STATUS HTTP & ERROR CODE

GUNAKAN TABEL BERIKUT UNTUK HANDLING RETRY DAN FALLBACK DI APLIKASI ANDA

Status	Error code	Keterangan
200 OK	-	Permintaan berhasil diproses. Biaya dihitung dari token aktual.
401 Unauthorized	invalid_api_key	Bearer token tidak valid, tidak aktif, atau sudah dicabut.
402 Payment Required	insufficient_balance	Saldo tersedia tidak cukup untuk reservasi biaya request.
402 Payment Required	balance_expired	Saldo melewati masa aktif 30 hari dan perlu top up baru.
404 Not Found	model_not_found	Model ID tidak ditemukan di katalog aktif.
429 Too Many Requests	rate_limit_exceeded	Request melebihi RPM pada API key terkait.
502 / 504 Gateway Error	upstream_error	Gangguan upstream. Hold saldo akan dirilis otomatis.

Kebijakan Masa Aktif Saldo 30 Hari

Saldo hasil top up aktif selama 30 hari kalender sejak pengisian terakhir. Top up baru sebelum masa berlaku berakhir akan memperpanjang seluruh saldo aktif Anda.

SUPPORT CENTER & TELEGRAM COMMUNITY

Butuh bantuan implementasi API, integrasi tools coding (Cline, Cursor, Continue), atau penyesuaian tier rate limit untuk aplikasi Anda? Tim teknis kami siap membantu di channel Telegram resmi.

Join Telegram Support