Dokümantasyon

ChatWise

ChatWise tüm sağlayıcıları aynı üç alanda yapılandırır. Özel sağlayıcıya bir ad ve API Base URL ile anahtar verin, Fetch'e basın; model seçicisi Claude ve GPT kimlikleriyle dolar ve hepsi aynı bakiyeyi kullanır.

Settings → Providers → "+", üç alandan özel sağlayıcı oluşturur — Provider name, https://api.kunavo.com/v1 olarak ayarlanmış API Base URL ve API Key — ardından Fetch model listesini uç noktadan okur.

Ayarlar → Sağlayıcılar → "+" → özel yapılandırma

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 sonundaki /v1 yolunu korur. ChatWise, alanın altında kuralı açıkça belirtir: “URL'ye /chat/completions eklemeyin.” Bu nedenle değer, yolun bağlandığı köktür; yolun kendisi değildir. Belgelerinde alanı doldurulmuş olarak gösterdiği tek barındırılan ağ geçidi de aynı biçimdedir: https://aihubmix.com/v1. Yol zaten eklenmiş bir temel URL, kimlik doğrulama hatası değil 404 hatası verir.

Bu yapılandırma, aşağıda belirtilen tarihte ChatWise'ın kendi belgelerinin okunmasına dayanır. Kunavo, ChatWise'ı kendi uç noktasıyla çalıştırıp denememiştir — ne bir oturumda, ne akışlı bir turda ne de bir araç gidiş dönüşünde. Aynı durum bu gruptaki tüm istemciler için geçerlidir. Yayımlanmış bir kurulum sayfası, uyumluluk testi değildir. Bunu denerken çalışan mevcut yolunuzu kullanıma hazır tutun.

Kunavo; embedding, metinden konuşmaya veya konuşmadan metne modeli sunmaz. Bu nedenle bu yol yalnızca sohbeti ve görüntü oluşturmayı yanıtlar. ChatWise'ın ses girişi özelliği farklıdır ve etkilenmez: transkripsiyon hizmetini çağırmak yerine, ses dosyasını kabul eden bir modele mesaj eki olarak ekler.

Bu alanı doldurmak, ChatWise'ın bir uzantısını devre dışı bırakır. Gözlemlenebilirlik sayfasındaki uyarı şöyledir: “İlgili sağlayıcının API Base URL alanının boş olduğundan emin olun; aksi hâlde gözlemlenebilirlik etkinleştirilmez.” Cloudflare AI Gateway panosu ve değiştirilmiş bir temel URL, sağlayıcı başına birbirini dışlar. Kunavo'yu yerleşik bir kaydı düzenlemek yerine kendi sağlayıcı kaydı olarak eklemek için bir neden de budur.

Birbiriyle ilgisi olmayan birkaç ürün ChatWise adını kullanıyor. Bu sayfa, belgeleri docs.chatwise.app adresinde bulunan ve chatwise.app adresinde sunulan macOS, Windows ve Linux masaüstü istemcisini ele alıyor. Herkese açık GitHub sürüm akışı, yayımlanan sürümün çok gerisinde kaldığından buradaki ekran görüntüsü gördüğünüzle uyuşmuyorsa uygulamanın kendi indirme sayfasını kontrol edin.

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 ChatWise kurulumunda açılır.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
ChatWise'ta Ayarlar → Sağlayıcılar bölümünü açın ve yeni sağlayıcı eklemek için "+"'ya tıklayın. Belgeler buradan iki yol sunuyor: yerleşik ön ayarlardan birini seçin veya özel bir yapılandırma oluşturun. Kunavo bir ön ayar olmadığından ikinci yolu izleyin.
Yukarıda olduğu gibi Sağlayıcı adı, API Base URL ve API Key alanlarını doldurun. Formdaki hiçbir şey bir satıcı seçmez: model kimliğini uç nokta çözümler. Dolayısıyla OpenAI uyumlu bir sağlayıcının arkasında Claude kimliği bulunması bir uyuşmazlık değil, amaçlanan yapılandırmadır.
Modeller satırında Fetch'e basın. ChatWise belgelerine göre API, /models uç noktasını destekliyorsa kullanılabilir modelleri sizin için ekleyebilir. Kunavo GET /v1/models isteğini yanıtladığından liste kendiliğinden dolar. Kimlikleri elle girmek isterseniz + New seçeneğini kullanabilirsiniz.
Bir modeli elle eklerseniz belgelerde alan adları şöyle belirtilir: Model ID API tanımlayıcısıdır, Display Name ise yalnızca etikettir; dolayısıyla kimlik katalogla tam olarak eşleşmelidir. Capabilities seçeneğini işaretleyin ve Context length değerini modele göre ayarlayın. Bu işaretler, uç noktaya ne yapacağını değil, istemcinin ne sunacağını bildirir.
Sağlayıcıyı model seçicisinden seçip bir mesaj gönderin. Görüntü modelleri için ChatWise'ın görüntü oluşturma sayfası bir adım daha belirtir: görüntü seçicisinde görünmeden önce model türü Image olarak ayarlanmalıdır.

ChatWise'ın özel sağlayıcı sayfası ile 21 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.

Kısa sürüm budur. Model seçimi, gerçek bir oturumun maliyeti ve hata durumlarını içeren tam rehber ChatWise'ı çalıştırmanın gerçek maliyeti içindedir.

İ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 ChatWise 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ış	ChatWise içinde kullanım alanı
`claude-sonnet-5`	$1.40 / $7.00	gündelik yazışmalar — dolar başına kaliteyi belirleyen uzun sohbetler
`claude-opus-5`	$3.50 / $17.50	aksi hâlde ikinci bir uygulamada açacağınız zor soru
`claude-haiku-4-5`	$0.70 / $3.50	başlıklar, özetler ve sohbet istemcisinin kendi başına yaptığı arka plan çağrıları
`gpt-5-6-terra`	$0.70 / $4.20	bağlam penceresinin belirleyici olduğu uzun belgeler ve büyük yapıştırılmış içerikler
`gpt-5-6-sol`	$2.00 / $12.00	aynı anahtarla başka bir aileden ikinci görüş

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

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

Ayarlar'ı açın, Sağlayıcılar'a gidin ve yeni bir sağlayıcı eklemek için "+" düğmesine tıklayın; ardından bir ön ayar seçin veya özel yapılandırma oluşturun. Sağlayıcı adını, API Base URL'yi ve API Key'i doldurun; Fetch düğmesiyle veya "+ New" seçeneğiyle modelleri ekleyin. ChatWise'ın kendi özel sağlayıcı belgeleri, bunu OpenAI uyumlu veya Anthropic uyumlu herhangi bir AI hizmetini entegre etme yöntemi olarak tanımlar. Dolayısıyla bir ağ geçidi kullanmak geçici bir çözüm değil, desteklenen bir senaryodur.

ChatWise API Base URL alanının sonunda /v1 bulunmalı mı?

OpenAI uyumlu bir uç nokta için evet. ChatWise, alanın altında kuralı belirtir: URL'ye /chat/completions eklemeyin. İstemci yolu kendisi ekler; bu nedenle değer /v1 kökü olmalıdır — https://api.kunavo.com/v1. ChatWise'ın alanı doldurulmuş olarak gösterdiği tek barındırılan ağ geçidi de aynı biçimdedir: https://aihubmix.com/v1. /v1'i atlamak, kimlik doğrulama hatası yerine 404 verir; iki hatayı ayırt etmenin en hızlı yolu budur.

ChatWise'ta Fetch neden model getirmiyor?

Liste, girdiğiniz anahtarla uç noktanın /models yolundan alınır. Bu nedenle boş sonuç genellikle boş bir kataloğa değil, anahtara veya temel URL'ye işaret eder. Uygulama dışında /v1/models adresine düz bir curl isteği göndererek aynı ikiliyi sınayın: JSON yanıtı sorunun sağlayıcı formunda olduğunu, 401 anahtarın, 404 ise URL'nin sorunlu olduğunu gösterir. Bunun yerine modelleri her zaman "+ New" ile elle ekleyebilirsiniz; bu durumda Model ID, katalog kimliğiyle tam olarak eşleşmelidir.

ChatWise kullanmak için abonelik veya lisans gerekir mi?

Bunlar birbirinden ayrı iki ödeme ilişkisidir. ChatWise bir kez satın aldığınız bir istemcidir; model erişimi ise anahtarınızı elinde bulunduran tarafından faturalandırılır. Kunavo anahtarında bu, aylık ek ücret olmadan token başına düşülen ön ödemeli bakiyedir. Sağlayıcı yapılandırması, ücretli katmanın sunduğu özellikler arasında listelenmiyor; ancak ChatWise'ın hiçbir sayfası ücretsiz katmanın özel sağlayıcı ekleyebileceğini açıkça belirtmiyor. Buna güvenmeden önce deneme sırasında doğrulayın.

ChatWise, Anthropic hesabı olmadan Claude modellerini kullanabilir mi?

Evet, OpenAI uyumlu bir sağlayıcı kaydı üzerinden. Model kimliği ChatWise içinde değil, yapılandırdığınız uç noktada çözülür; dolayısıyla elinizdeki kimlik bilgisi o uç noktaya aittir. Bu, uygulamada mevcut bir abonelikle oturum açmaktan farklı bir yoldur. ChatWise bu seçeneğin reklamını da yapar; ancak o yol başka bir satıcının koşullarına bağlıyken, sizin adınıza faturalandırılan bir anahtar böyle değildir. Kunavo, ChatWise'ı kendi uç noktasıyla çalıştırıp denememiştir; bu nedenle bu sayfayı test edilmiş bir sonuç değil, yapılandırma bilgisi olarak değerlendirin.