Kirim permintaan pertamamu
1. Isi saldo dan buat kunci
Isi saldo Rupiah, lalu buat kunci API di halaman Kunci API. Kunci hanya ditampilkan sekali.
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 page3. 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!"}]}'Contoh respons
{
"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.
Galat yang perlu ditangani
| HTTP | Kode | Arti |
|---|---|---|
| 402 | insufficient_balance | Saldo tidak cukup. Isi saldo untuk melanjutkan. |
| 402 | key_monthly_budget_exceeded | Anggaran bulanan kunci tercapai; reset pada tanggal 1 (WIB). |
| 402 | key_credit_limit_exceeded | Batas kredit total kunci tercapai. Naikkan batas atau pakai kunci lain. |
| 429 | rate_limited | Terlalu banyak permintaan. Tunggu sesuai header Retry-After. |
| 429 | free_daily_limit | Kuota harian model gratis habis. |
| 404 | no_eligible_endpoint | Tidak ada provider yang memenuhi kebijakan (PDP, wilayah, atau filter provider). |
| 502 | all_providers_failed | Semua provider gagal menjawab. Permintaan tidak dikenai biaya. |
| 401 | invalid_api_key | Kunci tidak ada, salah, atau sudah dicabut. |