Dokumentasi

Roo Code

Penyedia OpenAI Compatible di Roo Code terdiri dari tiga kolom dan satu blok kemampuan model. Blok kemampuan itu bukan sekadar hiasan opsional—Roo Code menggunakannya untuk menghitung anggaran konteks.

Pilih provider OpenAI Compatible, tempel base URL dan key, lalu atur context window dan max output model agar penganggaran Roo Code sendiri akurat.

Panel pengaturan Roo Code

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...
Model          claude-sonnet-5

Model Configuration
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on

Roo Code menggunakan pemanggilan alat native tanpa fallback, jadi model yang Anda pilih harus mendukung pemanggilan alat yang kompatibel dengan OpenAI. Setiap ID dalam tabel di bawah mendukungnya; model teks saja atau model media yang dikonfigurasi di sini akan gagal saat pertama kali agen mencoba menggunakan alat, bukan pada saat penyiapan.

Isi Context Window dan Max Output Tokens, jangan biarkan tetap pada nilai default. Roo Code menentukan kapan harus meringkas percakapan berdasarkan angka-angka tersebut. Jendela konteks yang disetel terlalu rendah membuat riwayat terpotong padahal tidak perlu, sedangkan nilai yang terlalu tinggi menghasilkan respons 400 dari upstream alih-alih peringkasan yang rapi.

Belum punya kunci? Buat akun Kunavo, buat kunci (diawali sk-kn-) dan tambahkan kredit mulai dari $10 — panggilan dibayar dari saldo tersebut, dan panggilan yang gagal tidak ditagihkan. Dasbor kemudian terbuka pada penyiapan Roo Code.

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Buka panel pengaturan Roo Code dan atur API Provider ke OpenAI Compatible.
Masukkan URL Dasar https://api.kunavo.com/v1 dan kunci Anda. Akhiran /v1 harus disertakan dalam URL dasar—Roo Code hanya menambahkan jalurnya.
Pilih atau ketik ID model, lalu buka Model Configuration dan atur jendela konteks, token output maksimum, dukungan gambar, serta harga input/output berdasarkan tabel di bawah.
Halaman penyedia Roo Code mencantumkan blok Konfigurasi Model tersebut dengan nama Max Output Tokens, Context Window, Image Support, Computer Use, Input Price, dan Output Price, serta menyebutkan bahwa Base URL “tidak akan berupa https://api.openai.com/v1”, alamat API OpenAI resmi (dokumentasi Roo Code, terakhir diperbarui 15 Mei 2026; dibaca 25 Oktober 2026).
Kirim pesan dalam Code mode. Harga yang dimasukkan di sini digunakan oleh tampilan biaya per tugas milik Roo Code, jadi pastikan nilainya benar.

Diperiksa terhadap Halaman penyedia OpenAI Compatible Roo Code pada 6 September 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Ini versi singkatnya. Panduan lengkap — pilihan model, biaya sesi nyata, dan mode kegagalan — ada di panduan Claude + Roo Code.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di Roo Code.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

ID model	Kunavo masuk / keluar	Kegunaannya di Roo Code
`claude-sonnet-5`	$1.40 / $7.00	Code mode — mode default dan acuan perhitungan biaya
`claude-opus-5`	$3.50 / $17.50	Architect mode, saat rencana yang salah lebih mahal daripada tokennya
`claude-haiku-4-5`	$0.70 / $3.50	Ask mode dan pembacaan file berulang
`gpt-5-6-terra`	$0.70 / $4.20	operasi dengan konteks panjang pada repositori besar

Penagihan dilakukan per token dari saldo prabayar tanpa biaya bulanan — lihat penagihan. Pada konteks berulang — yang merupakan sebagian besar kiriman editor atau klien obrolan — caching prompt lebih memengaruhi tagihan daripada pilihan model.

Pertanyaan umum

Bagaimana cara mengarahkan Roo Code ke endpoint kustom yang kompatibel dengan OpenAI?

Di panel pengaturan Roo Code, atur API Provider ke "OpenAI Compatible", lalu isi URL Dasar dan Kunci API untuk endpoint tersebut, kemudian pilih model. URL dasar adalah akar /v1 layanan karena Roo Code hanya menambahkan jalurnya. Dokumentasi Roo Code sendiri menyebut kolom URL Dasar sebagai hal yang sangat penting—kolom inilah yang menentukan tujuan setiap permintaan.

Model apa saja yang dapat digunakan dengan Roo Code melalui endpoint kustom?

Model apa pun yang disediakan endpoint dan mendukung pemanggilan alat native yang kompatibel dengan OpenAI. Roo Code hanya menggunakan pemanggilan alat native dan tidak memiliki mode fallback, jadi model tanpa dukungan alat akan terhubung, tetapi kemudian gagal begitu agen mencoba membaca atau menulis file. Semua model teks Claude dan GPT memenuhi syarat; model gambar, video, dan audio tidak.

Apa yang harus saya masukkan di Context Window dan Max Output Tokens Roo Code?

Batas sebenarnya dari model yang Anda pilih, bukan nilai default. Roo Code menggunakan kedua angka itu untuk menentukan kapan harus meringkas percakapan. Nilai di bawah batas konteks sebenarnya model membuat riwayat dibuang tanpa perlu, sedangkan nilai di atasnya menghasilkan error 400 dari upstream alih-alih peringkasan yang rapi. Rincian tiap model tersedia di katalog model endpoint.

Mengapa Roo Code melaporkan biaya tugas yang salah?

Karena Harga Input dan Harga Output di Model Configuration dimasukkan secara manual dan secara default bernilai nol atau menggunakan tarif penyedia lain. Roo Code menghitung biaya per tugas sepenuhnya dari kedua kolom itu—aplikasi tidak membaca harga dari endpoint—jadi akurasi angkanya bergantung pada nilai yang dimasukkan. Salin tarif dari katalog penyedia.