Dokumentasi

ChatWise

ChatWise menempatkan setiap penyedia di balik tiga kolom yang sama. Beri nama penyedia kustom, isi API Base URL dan kunci, lalu tekan Fetch; pemilih model akan menampilkan ID Claude dan GPT dengan satu saldo.

Settings → Providers → "+" membuat provider khusus dari tiga field — Provider name, API Base URL yang diatur ke https://api.kunavo.com/v1, dan API Key — lalu Fetch membaca daftar model dari endpoint.

Pengaturan → Penyedia → "+" → konfigurasi kustom

Provider name    Kunavo
API Base URL     https://api.kunavo.com/v1
                 field help: "Do NOT include /chat/completions in the URL"
API Key          sk-kn-...
Models           click Fetch to read the list from the endpoint,
                 or "+ New" and type an id by hand

"+ New" → Chat Models, the fields the docs name:
  Model ID       claude-sonnet-5
  Display Name   Claude Sonnet 5 (Kunavo)
  Capabilities   image input / reasoning flag — tick what the model does
  Context length as published on the models page

API Base URL harus menyertakan /v1. ChatWise mencantumkan aturan di bawah kolom itu — “JANGAN sertakan /chat/completions di dalam URL” — jadi nilainya adalah root tempat rute bermula, bukan rutenya. Satu-satunya gateway terhosting yang ditampilkan dalam dokumentasinya dengan kolom tersebut terisi menggunakan format yang sama, https://aihubmix.com/v1. Base URL yang sudah menyertakan rute akan gagal dengan 404, bukan dengan error autentikasi.

Konfigurasi ini merupakan pembacaan atas dokumentasi ChatWise sendiri pada tanggal di bawah. Kunavo belum menjalankan ChatWise terhadap endpoint-nya — belum untuk sesi, giliran streaming, maupun bolak-balik pemanggilan alat — dan hal yang sama berlaku untuk setiap klien dalam kelompok ini. Halaman panduan konfigurasi yang dipublikasikan bukanlah uji kompatibilitas. Pertahankan rute yang sudah berfungsi agar tetap tersedia saat mencoba konfigurasi ini.

Kunavo tidak menyediakan model embedding, text-to-speech, atau speech-to-text, jadi rute ini hanya menangani chat dan pembuatan gambar. Fitur input audio ChatWise adalah hal yang berbeda dan tidak terpengaruh: fitur itu melampirkan berkas audio ke pesan untuk model yang menerimanya, alih-alih memanggil layanan transkripsi.

Mengisi kolom ini menonaktifkan salah satu ekstensi ChatWise. Halaman observabilitasnya memperingatkan: “Pastikan API Base URL untuk penyedia terkait kosong, jika tidak, observabilitas tidak akan diaktifkan.” Dasbor Cloudflare AI Gateway dan Base URL yang diarahkan ulang tidak dapat digunakan bersamaan untuk satu penyedia — inilah salah satu alasan untuk menambahkan Kunavo sebagai entri penyedia tersendiri, alih-alih mengedit entri bawaan.

Beberapa produk yang tidak saling terkait menggunakan nama ChatWise. Halaman ini membahas klien desktop di chatwise.app — macOS, Windows, dan Linux — dengan dokumentasi di docs.chatwise.app. Feed rilis GitHub publiknya sudah lama tidak diperbarui dibandingkan versi yang tersedia, jadi periksa unduhan aplikasi itu sendiri jika tampilan di sini tidak sesuai dengan yang Anda lihat.

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

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Di ChatWise, buka Pengaturan → Penyedia, lalu klik "+" untuk menambahkan penyedia baru. Dokumentasinya menawarkan dua pilihan: pilih salah satu preset bawaan, atau buat konfigurasi kustom — Kunavo bukan preset, jadi pilih opsi kedua.
Isi Nama penyedia, API Base URL, dan API Key seperti di atas. Formulir ini tidak menentukan vendor: endpoint mengidentifikasi ID model, jadi ID Claude di balik penyedia yang kompatibel dengan OpenAI adalah kombinasi yang memang dimaksudkan, bukan ketidakcocokan.
Pada baris Model, tekan Fetch. Menurut dokumentasi ChatWise, jika API mendukung endpoint /models, aplikasi dapat menambahkan model yang tersedia untuk Anda; Kunavo merespons GET /v1/models, jadi daftar model terisi otomatis. Gunakan + Baru untuk ID yang ingin Anda masukkan sendiri.
Jika menambahkan model secara manual, dokumentasi menyebutkan nama kolomnya: ID Model adalah pengenal API, sedangkan Nama Tampilan hanya label, jadi ID harus sama persis dengan katalog. Centang Kapabilitas dan atur Panjang konteks sesuai model — tanda ini memberi tahu klien apa yang perlu ditawarkan, bukan memberi tahu endpoint apa yang harus dilakukan.
Pilih penyedia di pemilih model, lalu kirim pesan. Untuk model gambar, halaman pembuatan gambar ChatWise menambahkan satu langkah: jenis model harus diatur ke Gambar agar model muncul di pemilih gambar.

Diperiksa terhadap Halaman penyedia kustom ChatWise 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.

Ini versi singkatnya. Panduan lengkap — pilihan model, biaya sesi nyata, dan mode kegagalan — ada di biaya operasional ChatWise yang sebenarnya.

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

# 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 ChatWise
`claude-sonnet-5`	$1.40 / $7.00	percakapan sehari-hari — obrolan panjang yang kualitas per dolar menjadi penentu
`claude-opus-5`	$3.50 / $17.50	pertanyaan sulit yang biasanya membuat Anda membuka aplikasi kedua
`claude-haiku-4-5`	$0.70 / $3.50	judul, ringkasan, dan panggilan latar belakang yang dilakukan klien chat sendiri
`gpt-5-6-terra`	$0.70 / $4.20	dokumen panjang yang ditempel, saat jendela konteks menjadi batasannya
`gpt-5-6-sol`	$2.00 / $12.00	pendapat kedua dari keluarga model lain dengan kunci yang sama

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 menambahkan penyedia API kustom ke ChatWise?

Buka Pengaturan, pilih Penyedia, lalu klik "+" untuk menambahkan penyedia baru. Setelah itu, pilih preset atau buat konfigurasi kustom. Isi Nama penyedia, API Base URL, dan API Key, lalu tambahkan model dengan tombol Fetch atau "+ Baru". Dokumentasi penyedia kustom ChatWise sendiri menjelaskan bahwa fitur ini memungkinkan integrasi layanan AI apa pun yang kompatibel dengan OpenAI atau Anthropic, sehingga gateway merupakan penggunaan yang didukung langsung, bukan solusi alternatif.

Apakah API Base URL ChatWise perlu diakhiri /v1?

Untuk endpoint yang kompatibel dengan OpenAI, ya. ChatWise mencantumkan aturan di bawah kolom tersebut: jangan sertakan /chat/completions di URL. Klien menambahkan rutenya sendiri, jadi nilainya adalah root /v1 — https://api.kunavo.com/v1 — dan satu-satunya gateway terhosting yang didokumentasikan ChatWise dengan kolom tersebut terisi menggunakan format yang sama, https://aihubmix.com/v1. Jika /v1 tidak disertakan, hasilnya 404, bukan kegagalan autentikasi; ini cara tercepat untuk membedakan kedua kesalahan tersebut.

Mengapa Fetch tidak menampilkan model apa pun di ChatWise?

Daftar model diambil dari rute /models endpoint menggunakan kunci yang Anda masukkan, jadi hasil kosong biasanya menunjukkan masalah pada kunci atau URL dasar, bukan katalog yang kosong. Uji pasangan yang sama di luar aplikasi menggunakan curl biasa ke /v1/models: jika JSON diterima, masalahnya ada pada formulir penyedia; 401 berarti kuncinya salah; 404 berarti URL-nya. Model juga dapat ditambahkan secara manual dengan "+ Baru"; dalam hal ini, ID Model harus sama persis dengan ID di katalog.

Apakah saya memerlukan langganan atau lisensi ChatWise untuk menggunakan kunci API sendiri?

Keduanya merupakan hubungan pembayaran yang terpisah. ChatWise adalah klien yang dibeli sekali, sedangkan akses model ditagihkan oleh pemegang kunci Anda — jika menggunakan kunci Kunavo, saldo prabayar Anda akan berkurang untuk setiap token, tanpa biaya bulanan tambahan. Konfigurasi penyedia tidak tercantum sebagai salah satu fitur yang dibuka oleh paket berbayar, tetapi tidak ada halaman ChatWise yang menyatakan secara tegas bahwa paket gratis dapat menambahkan penyedia kustom. Jadi, pastikan saat masa uji coba sebelum mengandalkannya.

Bisakah ChatWise menggunakan model Claude tanpa akun Anthropic?

Ya, melalui entri penyedia yang kompatibel dengan OpenAI. ID model diidentifikasi oleh endpoint yang Anda konfigurasi, bukan oleh ChatWise, jadi kredensial yang Anda gunakan adalah milik endpoint tersebut. Jalur ini berbeda dari masuk menggunakan langganan yang sudah ada di aplikasi, yang juga ditawarkan ChatWise: jalur tersebut bergantung pada ketentuan vendor lain, sedangkan kunci yang ditagihkan kepada Anda tidak. Kunavo belum menjalankan ChatWise terhadap endpoint-nya, jadi anggap halaman ini sebagai panduan konfigurasi, bukan hasil pengujian.