Dokümantasyon

Chatbox

Chatbox, uç nokta adresini ana makine ve yol olarak ikiye ayırır ve yolu sizin için doldurur. Bu nedenle ana makine, kaynak adresidir; bu istemcinin teşvik ettiği tek hata, buraya /v1 eklemektir.

API Host'u hizmet köküne ayarlanmış OpenAI API Compatible türünde bir sağlayıcı ekleyin — Chatbox /v1/chat/completions yolunu kendisi ekler.

Chatbox ayarları

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 değeri https://api.kunavo.com olmalı ve /v1 içermemelidir. Chatbox'ta ayrı bir API Path alanı bulunur ve varsayılan değeri /v1/chat/completions olarak ayarlanmıştır. Bu nedenle sonunda zaten /v1 bulunan bir ana makine, /v1/v1/chat/completions yoluna istek gönderilmesine yol açar. Farklı bir gereksiniminiz olduğunu bilmiyorsanız yolu boş bırakın.

Chatbox'ın sağlayıcı türü seçicisi, istek biçimini belirtir. OpenAI API 兼容 (OpenAI API uyumlu) seçeneğini belirleyin, ardından bir Claude model kimliği girin. Kimlik uç noktada çözümlendiğinden bu ikisi birbiriyle çelişmez.

Henüz anahtarınız yok mu? Bir Kunavo hesabı oluşturun, bir anahtar oluşturun ( sk-kn- ile başlar) ve $10'dan kredi ekleyin — çağrılar bu bakiyeden ödenir ve başarısız çağrılar ücretlendirilmez. Ardından kontrol paneli Chatbox kurulumunda açılır.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
Ayarlar → Model Sağlayıcıları bölümünü açın ve Ekle'ye tıklayın.
Sağlayıcıya bir ad verin, türünü OpenAI API 兼容 olarak ayarlayın ve API Anahtarını yapıştırın.
API 主机 / API Host alanını https://api.kunavo.com'a ayarlayın ve API 路径 / API Path alanını boş bırakın.
İstediğiniz model kimliklerini ekleyip kaydedin ve bir konuşma başlatın.

Chatbox'ın sağlayıcı yapılandırma kılavuzu ile 6 Eylül 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar Chatbox içinde çalışır.

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

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Model kimliği	Kunavo giriş / çıkış	Chatbox içinde kullanım alanı
`claude-sonnet-5`	$1.40 / $7.00	varsayılan konuşma modeli
`claude-haiku-4-5`	$0.70 / $3.50	gecikmenin ve fiyatın önem taşıdığı kısa etkileşimler
`claude-opus-5`	$3.50 / $17.50	zor sorular için tutulan ikinci bir sağlayıcı kaydı
`gpt-5-6-terra`	$0.70 / $4.20	aynı anahtarda farklı bir model ailesi

Faturalandırma aylık ücret olmadan, ön ödemeli bakiyeden token başına yapılır — faturalandırmaya bakın. Tekrarlanan bağlamda — bir düzenleyicinin veya sohbet istemcisinin gönderdiği içeriğin çoğu budur — istem önbellekleme, faturayı model seçiminden daha fazla değiştirir.

Sık sorulan sorular

OpenAI uyumlu bir uç nokta için Chatbox'ın API Host alanına ne girmeliyim?

Bir yol içermeyen kaynak adresi; örneğin https://api.example.com. Chatbox'ın ayrı bir API Path alanı vardır ve varsayılanı /v1/chat/completions'tır. Belgelerine göre bu alanın genellikle doldurulması gerekmez. Yani /v1, ana makineden değil yoldan gelir. Sonunda /v1 bulunan bir ana makine, /v1/v1/chat/completions adresine istek gönderilmesine ve 404 hatasına yol açar.

Chatbox'a özel bir model sağlayıcısını nasıl eklerim?

Ayarlar → Model Sağlayıcıları bölümünü açın ve Ekle'ye tıklayın. Sağlayıcıya bir ad verin, OpenAI uyumlu API türünü seçin, API anahtarını yapıştırın, API Host alanını uç noktanın kaynak adresine ayarlayın ve API Path alanını boş bırakın. Kullanmak istediğiniz model kimliklerini ekleyip kaydedin; sağlayıcı her konuşmanın model seçicisinde görünür.

Chatbox, Claude modelleriyle konuşabilir mi?

Evet, bunları sunan OpenAI uyumlu bir uç nokta üzerinden. Chatbox, girdiğiniz model kimliğini yapılandırılmış ana makineye gönderir; dolayısıyla Claude kimliği Chatbox'ta değil, uç noktada çözümlenir ve uygulamanın kendi Anthropic kimlik bilgilerine ihtiyacı olmaz. Sağlayıcı türü seçicisi bir satıcıyı değil, istek biçimini belirler.

Chatbox'ın API Path alanını ne zaman doldurmalıyım?

Yalnızca uç nokta, /v1/chat/completions adresinde chat completions sunmuyorsa. Bu alan, alışılmadık yönlendirmeye sahip ağ geçitleri içindir. Standart bir OpenAI uyumlu hizmette boş bırakmak doğrudur; buraya yol girmek, kimlik doğrulama sorununa benzeyen 404 hatalarının yaygın bir nedenidir.