Jan Agent

Satu baris `jan config set --base-url https://api.kunavo.com/v1` menulis Kunavo ke ~/.jan/config.toml, dan CLI pratinjau Jan Agent — yang tidak menyertakan mesin inferensi — berjalan dengan key tersebut.

# Jan Agent is a preview on a nightly channel — check your build first.
jan --version

jan config set \
  --provider kunavo \
  --api-key sk-kn-... \
  --base-url https://api.kunavo.com/v1 \
  --model claude-sonnet-5 \
  --model claude-haiku-4-5 \
  --api-type openai

jan config list   # configured providers as JSON, keys redacted

Langkah demi langkah

1. Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
2. Pastikan yang Anda konfigurasi adalah jan --version. Jan Desktop juga menyediakan CLI yang dijalankan dengan jan, tetapi perintahnya berbeda. Jadi, pastikan jan config set --help mencantumkan --base-url sebelum Anda mengetik sisanya.
3. Jalankan baris jan config set di atas. --provider adalah ID yang Anda pilih sendiri, bukan nama dari daftar tetap — contoh perangkat keras lokal dalam dokumentasi mereka menggunakan --provider local — dan --model dapat diulang, serta mengganti daftar yang sudah ada alih-alih menambahkannya.
4. Pastikan konfigurasi berhasil diterapkan dengan jan config list (key disamarkan) atau jan config path untuk file itu sendiri, lalu jalankan jan cli models list untuk melihat semua model yang ditawarkan setiap provider. ID model yang diketik sendiri akan tetap ada meskipun endpoint berhenti mencantumkannya; jan cli models refresh --provider kunavo menggunakan daftar dari endpoint sebagai acuan.
5. Masuk ke direktori proyek dan jalankan jan, lalu pilih model dengan /model. Untuk uji coba pertama, pilih jan --plan: mode baca saja, sehingga ketidakcocokan protokol terlihat sebelum ada apa pun yang ditulis ke disk.
6. Berikan tugas yang mengedit file. Jan Agent adalah agen, jadi uji coba pertama sebaiknya menguji pemanggilan tool dan streaming — hal-hal inilah yang pertama kali gagal jika endpoint hanya cocok sebagian, sementara sapaan tidak menguji keduanya.

Diperiksa terhadap Halaman Providers Jan Agent pada 21 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.

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 Jan Agent.

# 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.

Ada dua hal berbeda yang disebut key API Jan

Keduanya berada di file yang sama tetapi memiliki arti yang berlawanan. Karena itu, jan config list dapat tampak keliru bagi orang yang mengharapkan jenis lainnya.

Jan Desktop tidak menerbitkan keduanya: aplikasi ini tidak memiliki akun, jadi tidak ada yang dapat dibuat di sana. Server API lokalnya menerima kunci yang Anda buat sendiri, yang merupakan makna ketiga dan digunakan pada host yang berbeda.

Apa yang diwariskan Jan Desktop, dan batas pewarisan tersebut

Jan Agent membaca empat sumber untuk pengaturan penyedia, masing-masing mengungguli sumber di atasnya, dan sumber kedua biasanya mengejutkan pengguna.

1. ~/.jan/config.toml — dasar konfigurasi, dan satu-satunya file yang ditulis oleh jan config set.
2. settings.json milik Jan Desktop — hanya diwarisi. Sumber ini menambahkan penyedia yang belum Anda konfigurasikan di Agent, tidak pernah menimpa penyedia yang sudah Anda konfigurasikan, dan tidak pernah ditulis kembali.
3. Blok [provider] dalam agent.toml sebuah proyek — pilihan eksplisit per proyek, sehingga mengungguli keduanya. File tersebut biasanya masuk ke commit, jadi jangan sertakan api_key di dalamnya.
4. --provider / --api-key pada baris perintah, atau JAN_API_KEY / <PROVIDER>_API_KEY — yang paling eksplisit dan paling sementara.

Ada dua konsekuensi yang perlu diketahui sebelum Anda men-debug hal yang salah. jan config list dapat melaporkan tidak ada penyedia, sementara jan cli models list mengembalikan banyak penyedia — yang kedua menyertakan penyedia yang diwarisi dari Desktop, yang tidak disimpan dalam ~/.jan/config.toml. Selain itu, penyedia yang diwarisi tidak pernah diperbarui karena tidak ada entri di sini untuk ditulis ulang: jika Anda ingin daftar model Kunavo selalu mutakhir, penyedia tersebut harus memiliki entri jan config set tersendiri, yang dibuat oleh blok di atas.

Ketika dua penyedia menawarkan ID model yang sama

Kunavo menyediakan ID seperti claude-sonnet-5, begitu pula entri penyedia yang diarahkan langsung ke vendor. Jan Agent harus memilih salah satunya, dan urutan yang didokumentasikan adalah: pertama, kecocokan persis dalam daftar models penyedia, lalu awalan <provider>/<model> yang menyebutkan penyedia yang telah dikonfigurasikan, dan ketika beberapa penyedia menawarkan ID yang sama, penyedia dengan kredensial mengungguli penyedia serupa tanpa kunci. Jadi, kunavo/claude-sonnet-5 adalah cara Anda menyatakan penyedia yang dimaksud. Penanda penyedia tersebut hanya digunakan oleh Jan — penanda ini dihapus sebelum permintaan dikirim, karena layanan upstream menolak ID yang menyertakan penanda penyedia.

Entri yang sama, dari dalam konsol

Jika Anda lebih memilih tidak mengetik flag: /settings > providers mengelola entri ~/.jan/config.toml yang sama, dan a membuka formulir penambahan dengan kolom name, base url, api key, dan models yang dipisahkan dengan spasi. Ada dua hal yang dilakukan formulir ini tetapi tidak dilakukan oleh flag: URL dasar harus menggunakan https:// (atau http:// untuk endpoint localhost), sehingga kunci tidak pernah dikirim melalui koneksi jarak jauh tanpa enkripsi — Kunavo menggunakan https://, jadi ini bukan kendala — dan saat mengedit, kolom kunci API menampilkan (unchanged) serta mempertahankan nilai yang tersimpan kecuali Anda mengetik di dalamnya. Mengosongkan kolom tersebut menghapus kunci, bukan membiarkannya tetap tersimpan.