Dokumentasi

Chatbox

Chatbox memisahkan endpoint menjadi host dan path, lalu mengisi path untuk Anda. Artinya, host adalah origin — kesalahan yang mungkin terjadi pada klien ini adalah memasukkan /v1 ke dalamnya.

Tambahkan provider bertipe OpenAI API Compatible dengan API Host diatur ke root layanan — Chatbox sendiri menambahkan /v1/chat/completions.

Pengaturan Chatbox

Settings → Model Providers → Add

  API 提供方名称 / Provider name   Kunavo
  API 类型 / Type                 OpenAI API 兼容 (OpenAI API compatible)
  API 密钥 / API Key              sk-kn-...
  API 主机 / API Host             https://api.kunavo.com
  API 路径 / API Path             (leave empty → /v1/chat/completions)
  Model                           claude-sonnet-5

API Host adalah https://api.kunavo.com, tanpa /v1. Chatbox memiliki kolom API Path terpisah yang secara bawaan bernilai /v1/chat/completions, jadi host yang sudah diakhiri /v1 akan menghasilkan permintaan ke /v1/v1/chat/completions. Biarkan path kosong, kecuali Anda tahu perlu mengisinya dengan nilai lain.

Pemilih jenis penyedia Chatbox menentukan format wire. Pilih Kompatibel dengan OpenAI API (OpenAI API compatible), lalu masukkan ID model Claude — ID tersebut diidentifikasi oleh endpoint, jadi keduanya tidak bertentangan.

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

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Buka Pengaturan → Penyedia Model, lalu klik Tambah.
Beri nama penyedia, atur jenisnya ke Kompatibel dengan OpenAI API, lalu tempelkan API Key.
Atur Host API / API Host ke https://api.kunavo.com dan biarkan Path API / API Path kosong.
Tambahkan ID model yang Anda inginkan, simpan, lalu mulai percakapan.

Diperiksa terhadap Panduan konfigurasi penyedia Chatbox 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.

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

# 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 Chatbox
`claude-sonnet-5`	$1.40 / $7.00	model percakapan bawaan
`claude-haiku-4-5`	$0.70 / $3.50	percakapan singkat, saat latensi dan harga sama-sama penting
`claude-opus-5`	$3.50 / $17.50	entri penyedia kedua untuk pertanyaan sulit
`gpt-5-6-terra`	$0.70 / $4.20	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

Apa yang harus diisi pada API Host Chatbox untuk endpoint yang kompatibel dengan OpenAI?

Origin tanpa path — misalnya https://api.example.com. Chatbox memiliki kolom API Path terpisah yang secara bawaan bernilai /v1/chat/completions dan yang menurut dokumentasinya umumnya tidak perlu diisi, jadi /v1 berasal dari path, bukan host. Host yang diakhiri /v1 akan menghasilkan permintaan ke /v1/v1/chat/completions dan mendapat respons 404.

Bagaimana cara menambahkan penyedia model kustom di Chatbox?

Buka Pengaturan → Penyedia Model, lalu klik Tambah. Beri nama penyedia, pilih jenis API yang kompatibel dengan OpenAI, tempelkan kunci API, atur API Host ke origin endpoint, dan biarkan API Path kosong. Tambahkan ID model yang ingin digunakan lalu simpan; penyedia tersebut kemudian muncul di pemilih model pada setiap percakapan.

Bisakah Chatbox menggunakan model Claude?

Ya, melalui endpoint kompatibel OpenAI yang menyediakannya. Chatbox mengirimkan ID model yang Anda masukkan ke host yang dikonfigurasi, sehingga ID Claude diidentifikasi di sana, bukan di Chatbox, dan aplikasi tidak memerlukan kredensial Anthropic sendiri. Pemilih jenis penyedia menentukan format wire, bukan vendor.

Kapan saya perlu mengisi API Path Chatbox?

Hanya jika endpoint tidak menyediakan chat completions di /v1/chat/completions. Kolom ini ditujukan untuk gateway dengan perutean yang tidak biasa; untuk layanan standar yang kompatibel dengan OpenAI, membiarkannya kosong adalah pilihan yang tepat. Mengisi path sering menyebabkan 404 yang tampak seperti masalah autentikasi.