Koneksia Labs
IDENBahasa IndonesiaMasukDaftar gratis
Mode uji — saldo dan pembayaran bukan uang nyata.

Kirim permintaan pertamamu

1. Isi saldo dan buat kunci

Isi saldo Rupiah, lalu buat kunci API di halaman Kunci API. Kunci hanya ditampilkan sekali.

Isi saldoBuat kunci API

2. Atur base URL dan kunci

Simpan base URL dan kunci sebagai variabel lingkungan. ROUTER_BASE_URL sudah termasuk /v1. Jangan menaruh kunci di kode browser.

export ROUTER_BASE_URL="https://api.koneksialabs.ai.id/v1"
export ROUTER_API_KEY="sk-kl-..."   # dari halaman Kunci API / from the API keys page

3. Kirim pesan

Gunakan SDK OpenAI resmi; hanya base URL dan kunci yang berubah. Ganti MODEL_ID dengan ID dari katalog.

curl "$ROUTER_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $ROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_ID","messages":[{"role":"user","content":"Halo!"}]}'

Jalankan contoh JavaScript di server, bukan di browser yang memegang kunci rahasia.

Contoh respons

Contoh, bukan hasil uji nyata.

{
  "id": "gen-0000-contoh",
  "object": "chat.completion",
  "model": "MODEL_ID",
  "choices": [{ "index": 0, "message": { "role": "assistant", "content": "Halo! Ada yang bisa saya bantu?" }, "finish_reason": "stop" }],
  "usage": {
    "prompt_tokens": 9, "completion_tokens": 12, "total_tokens": 21,
    "cost": 0.000235, "cost_micro_idr": "235"
  }
}
Streaming

Chunk terakhir (choices kosong) membawa usage. Biaya akhir berasal dari metering server; cek ulang lewat /v1/generation bila koneksi terputus.

curl -N "$ROUTER_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $ROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_ID","stream":true,"messages":[{"role":"user","content":"Halo!"}]}'

4. Periksa biaya

Setiap respons membawa usage.cost (IDR) dan usage.cost_micro_idr (nilai pasti). Lihat rincian per permintaan dan potongan cache di Aktivitas.

Buka Aktivitas

Galat yang perlu ditangani

Kode galat API (bahasa Inggris) dan artinya
HTTPKodeArti
402insufficient_balanceSaldo tidak cukup. Isi saldo untuk melanjutkan.
402key_monthly_budget_exceededAnggaran bulanan kunci tercapai; reset pada tanggal 1 (WIB).
402key_credit_limit_exceededBatas kredit total kunci tercapai. Naikkan batas atau pakai kunci lain.
429rate_limitedTerlalu banyak permintaan. Tunggu sesuai header Retry-After.
429free_daily_limitKuota harian model gratis habis.
404no_eligible_endpointTidak ada provider yang memenuhi kebijakan (PDP, wilayah, atau filter provider).
502all_providers_failedSemua provider gagal menjawab. Permintaan tidak dikenai biaya.
401invalid_api_keyKunci tidak ada, salah, atau sudah dicabut.
Kirim permintaan pertamamu · Koneksia Labs