Agen AI & gateway

OpenHands

Agen coding otonom (eks OpenDevin). Set LLM base URL + model kustom.

Base URL dan API key diambil dari dasbor RouterKu (menu Integrasi & Kunci API). Pada contoh, ganti BASE_URL_DARI_DASBOR (berakhiran /v1), HOST_DARI_DASBOR (tanpa /v1) dan qdr-... dengan nilai milikmu.

OpenHands (eks OpenDevin) adalah agen coding otonom. Ia memakai LiteLLM, jadi model kustom perlu prefiks openai/.

Nilai koneksi

Base URL	`BASE_URL_DARI_DASBOR`
API Key	`qdr-... (buat di menu Kunci API)`
Model	`sonnet-5 / opus-5`

Langkah-langkah

Buat kunci RouterKu
Menu Kunci API → buat kunci (qdr-...).
Buka setelan LLM
OpenHands → Settings → tab LLM → aktifkan Advanced.
Isi model & koneksi
Custom Model openai/sonnet-5
Base URL BASE_URL_DARI_DASBOR
API Key qdr-...
Simpan lalu mulai tugas coding.

Prefiks openai/ wajib supaya LiteLLM memakai jalur OpenAI-compatible. Tanpa itu model tak dikenal.

Model yang disarankan

`opus-5`	Terkuat — penalaran mendalam untuk tugas berat, banyak tool, dan agen coding.
`sonnet-5`	Andalan harian (default) — seimbang antara kualitas, kecepatan, dan biaya.
`haiku-45`	Tercepat & termurah — balasan chat ringan, klasifikasi, dan boilerplate.

Asisten coding mengirim konteks besar dan banyak panggilan tool. Batas RouterKu per akun: 240 permintaan/menit dan 24 paralel — cukup untuk kerja normal. Pakai opus-5 untuk tugas berat, sonnet-5 untuk kerja harian yang lebih hemat.

Tips

Untuk tugas multi-langkah panjang, pakai openai/opus-5 agar penalaran tool tetap kuat.
Kalau jalan di Docker, pastikan container bisa menjangkau host Base URL RouterKu.
Batasi iterasi agen di setelan agar hemat token pada tugas besar.

Kalau bermasalah

401 / authentication failed / invalid_api_key — cek dulu apakah kuncinya memang mati, atau cuma tidak sampai ke permintaan. Jalankan uji mandiri di bawah: kalau balasannya 200, kunci kamu SEHAT dan masalahnya ada di konfigurasi OpenHands (lihat 3 poin berikutnya). Kalau bukan 200, buat kunci baru di menu Kunci API.
401 padahal kunci sehat (1) — belum restart OpenHands. Banyak aplikasi hanya membaca file .env/variabel lingkungan saat start. Setelah mengubah kunci, tutup penuh lalu jalankan ulang OpenHands.
401 padahal kunci sehat (2) — penulisan kunci kotor. Di file .env tulis polos tanpa kutip/spasi: ROUTERKU_API_KEY=qdr-... (bukan = "qdr-..."). Pastikan tidak ada spasi di ujung dan kunci tersalin utuh (tanpa terpotong).
401 padahal kunci sehat (3) — nama variabel salah. Rujukan seperti ${ROUTERKU_API_KEY} umumnya hanya dikenali bila namanya HURUF BESAR dan variabelnya benar-benar ada; kalau tidak, teks ${...} terkirim mentah sebagai kunci → 401. Saat ragu, isi kunci qdr-... langsung untuk memastikan.
402 / insufficient_balance — saldo habis. Isi lewat menu Isi Saldo.
404 / model_not_found — ID model salah. Pakai persis, mis. sonnet-5 (daftar di GET /v1/models).
Tidak konek / timeout — pastikan Base URL berakhiran /v1 dan bisa diakses dari mesin OpenHands.
429 / rate_limited — melewati 240 permintaan/menit atau 24 paralel. Beri jeda atau kurangi konkurensi.

Uji mandiri kunci — jalankan di terminal mesin yang sama. Ganti qdr-... dengan kuncimu:

Terminal

curl -s -o /dev/null -w "%{http_code}\n" BASE_URL_DARI_DASBOR/chat/completions \
  -H "Authorization: Bearer qdr-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"haiku-45","max_tokens":10,"messages":[{"role":"user","content":"ping"}]}'

Hasil 200 = kunci dan saldo RouterKu sehat, jadi penyebab 401 ada di konfigurasi aplikasinya (paling sering: aplikasi belum di-restart setelah kunci diubah). Hasil 401 = kunci salah/dicabut → buat ulang di menu Kunci API. Hasil 402 = saldo habis → menu Isi Saldo.

Buat akun & kunci Lihat ID model

Agen AI & gateway lain

Hermes Agent OpenClaw 9 9Router Goose A AutoGen CrewAI

Siap mulai pakai AI tanpa ribet?

Daftar gratis, isi saldo mulai Rp20.000 lewat QRIS, dan langsung tancap gas di editor atau aplikasimu.

Buat akun gratis Baca dokumentasi

Custom Model	`openai/sonnet-5`
Base URL	`BASE_URL_DARI_DASBOR`
API Key	`qdr-...`