Dokümantasyon

TypingMind

TypingMind'da özel modeller için temel URL alanı yoktur: her model, tam uç nokta rotası, model kimliği, bağlam uzunluğu ve kendinizin başlık olarak girdiği anahtarla ayrı bir girdidir. Kunavo için bu girdiyi ve bir ay önce çalışmazken artık neden tarayıcıdan çalıştığını burada açıklıyoruz.

Models → Add custom model: tam Endpoint URL https://api.kunavo.com/v1/chat/completions, Bearer ve anahtarınızı içeren bir Authorization başlığı, Model ID ve bağlam uzunluğu — her model için bir girdi, doğrudan tarayıcınızdan çağrılır.

typingmind.com — Özel Model Ekle

Models  →  Add custom model  →  Create Manually

Name                    Kunavo · Claude Sonnet 5
Model ID                claude-sonnet-5
Context Length          1000000

Authentication tab
  API Type              OpenAI Chat Completions API
  Endpoint URL          https://api.kunavo.com/v1/chat/completions
  Authentication Type   API Key via HTTP Header
    Header Key          Authorization
    Header Value        Bearer sk-kn-...

Capabilities tab        tick only what you have checked (see below)
Request Options tab     leave "Route requests via TypingMind Cloud" off

                        → Test & Save

Endpoint URL tam rotadır, temel URL değildir. OpenAI Chat Completions API türü için bu değer https://api.kunavo.com/v1/chat/completions olur. TypingMind herhangi bir şey eklemez — kendi örneklerinde https://api.minimax.io/v1/chat/completions gibi tam rotalar yapıştırılır — bu nedenle yalnızca https://api.kunavo.com/v1 kullanıldığında sohbet isteği var olmayan bir yola gönderilir.

Tarayıcınızdan çalışır ve artık Kunavo ile çalışmaktadır. TypingMind belgeleri isteklerin “doğrudan tarayıcıdan” gönderildiğini belirtir; bu nedenle uç noktanın sayfanın kaynağına izin vermesi gerekir. Kunavo'nun API'si 29 Eylül 2026'da CORS başlıklarını ekledi. 1 Ekim 2026'da doğrudan typingmind.com sayfasından gönderilen bir istek access-control-allow-origin: * ve okunabilir bir yanıtla geri döndü; bu sonuç /v1/chat/completions, /v1/messages ve /v1/models için de aynıydı. Bu uç nokta için Route requests via TypingMind Cloud seçeneğine ihtiyacınız yoktur.

Nelerin test edilip edilmediği. Yukarıdaki form etiketleri 1 Ekim 2026'da canlı uygulamadan okundu ve çapraz kaynaklı istek, kasıtlı olarak geçersiz bir anahtarla bu sayfadan gönderildi — dolayısıyla kanıtlanan şey, tarayıcının TypingMind'ın Kunavo'ya ulaşmasına ve yanıtı okumasına izin vermesidir. Kunavo'ya karşı TypingMind üzerinden gerçek bir anahtarla herhangi bir tamamlama, akış veya araç çağrısı çalıştırılmadı ve Test & Save düğmesine basılmadı. Uçtan uca ilk kontrol, kendi Test & Save işleminizdir.

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

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
TypingMind'da sol kenar çubuğunda Models bölümünü açın ve Add custom model seçeneğine tıklayın. Create Manually seçeneğinde kalın; Import JSON ve Import OpenRouter diğer kaynaklar içindir.
Name alanını (istediğiniz değer), Model ID alanını ( GET /v1/models tarafından listelendiği biçimde tam olarak — örneğin claude-sonnet-5 ) ve Context Length alanını doldurun. Form 128000 değerini önceden doldurur; modelin gerçek pencere boyutunu models page üzerinden ayarlayın, çünkü TypingMind ne kadar geçmiş göndereceğine karar vermek için bu sayıyı kullanır.
Kimlik Doğrulama sekmesinde API Türü = OpenAI Chat Completions API seçeneğini seçin, tam Uç Nokta URL'sini yapıştırın, Kimlik Doğrulama Türünü HTTP Üst Bilgisi aracılığıyla API Anahtarı olarak ayarlayın ve Üst Bilgi Anahtarı alanına Authorization, Üst Bilgi Değeri alanına ise Bearer sk-kn-... girin — Bearer sözcüğü, bir boşluk ve ardından anahtar.
Yetenekler bölümünde özellikleri tek tek işaretleyin veya Kaydederken yetenekleri otomatik denetle seçeneğini açık bırakın — form, kaydederken “birkaç test isteği” gönderdiğini söylüyor; bu da birkaç token ücretlendirilmesine neden olur. İsteğe bağlı olarak Fiyatlandırma alanını aşağıdaki tablodaki milyon token başına ücretlerle doldurarak TypingMind'ın maliyet gösteriminin faturanızla eşleşmesini sağlayabilirsiniz. Ardından Test Et ve Kaydet'e tıklayın.
Her model için tekrarlayın. Özel uç nokta için sağlayıcı düzeyinde bir kayıt yoktur: Claude Sonnet, Claude Haiku ve bir GPT modeli, aynı Uç Nokta URL'sini ve üstbilgiyi kullanan üç ayrı özel modeldir.

TypingMind model belgeleri ile 1 Ekim 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 TypingMind fiyatlandırması ve API 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 TypingMind 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ış	TypingMind içinde kullanım alanı
`claude-sonnet-5`	$1.40 / $7.00	Uzun sohbetler ve belgeler için günlük kullanım modeli — bağlam uzunluğu 1000000
`claude-haiku-4-5`	$0.70 / $3.50	Hızlı sorular ve başlıklar için ucuz ikinci seçenek — bağlam uzunluğu 200000
`claude-opus-5`	$3.50 / $17.50	Tek sohbette yoğun akıl yürütme; bilinçli olarak kullanılır — bağlam uzunluğu 1000000

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.

Diğer üç API türü

Canlı formdaki API Türü açılır listesinde OpenAI Chat Completions API, OpenAI Responses API, Claude Messages API ve Gemini API seçenekleri bulunur. Kunavo ilk üçünü yanıtlar; her biri için Uç Nokta URL'sinde kendine ait tam rota gerekir.

Claude Messages API — Uç Nokta URL'si https://api.kunavo.com/v1/messages. TypingMind'ın kendi Claude biçimli örneğinde x-api-key üstbilgisi kullanılıyor; Kunavo bu rotada bunu da Authorization: Bearer üstbilgisini de kabul eder. Kunavo bu rotada yalnızca Claude ailesine ait kimlikleri sunar.
OpenAI Responses API — Uç Nokta URL'si https://api.kunavo.com/v1/responses, aynı Bearer üstbilgisi. TypingMind belgelerinde bu tür için işlenmiş bir örnek yoktur; bu nedenle tam rota biçimi alıntılanmış değil, diğer üç örnekten çıkarılmıştır.
Gemini API — bu uç nokta için uygun değildir. Google'ın kendi istek biçimini bekler; Gemini modellerine bunun yerine Chat Completions türü üzerinden erişin.

Bu, TypingMind API'si değildir

“TypingMind API” genellikle bir TypingMind Teams örneğinin REST API'sini (custom.typingmind.com) ifade eder; bu API sohbet örneğini yönetir. Model tokenları satmaz ve bu kurulumla ilgisi yoktur. Özel model, TypingMind'ın sağladığınız bir anahtarla başka birinin uç noktasını çağırmasından ibarettir.

İki ayrı fatura

TypingMind lisansı uygulama ücretini karşılar. Özel model üzerinden gönderdiğiniz her mesaj, üstbilgideki anahtarın sahibi tarafından token başına ücretlendirilir — burada ön ödemeli bakiyenizden Kunavo tarafından. Lisans katmanları ve bu ücretlerle bir aylık sohbetin maliyeti TypingMind fiyatlandırması ve API maliyeti başlığında ayrıntılı olarak ele alınmıştır.

Test Et ve Kaydet işlemi başarısız olduğunda

“POST /v1 temel URL'dir, uç nokta değildir” mesajını içeren 404 (veya URL ana bilgisayar adında bitiyorsa “Bulunamadı: /”) — Uç Nokta URL'sinde rota eksiktir. URL /v1/chat/completions (veya bu türler için /v1/messages, /v1/responses) ile bitmelidir. 2026-10-01 tarihinden önce ikisi de HTML sayfası döndürüyordu.
“Böyle bir uç nokta yok” mesajını içeren 404 — rota yanlış yazılmıştır; örneğin /v1/chat/completion. Aynı mesajda Kunavo'nun sunduğu en yakın rota da belirtilir.
“Bulunamadı: /chat/completions. Kunavo'nun API'si /v1 altında çalışır” mesajını içeren 404 — rota mevcut, ancak /v1 yok: Uç Nokta URL'si https://api.kunavo.com/chat/completions olarak ayarlanmış. Rotanın önüne /v1 ekleyin. (2026-10-01 tarihinde kontrol edildi; bu tarihten önce aynı hata HTML sayfası döndürüyordu.)
401 “API anahtarı eksik veya geçersiz” — üstbilgi yanlış: Üstbilgi Anahtarı Authorization olmalı ve değer Bearer ile başlamalıdır ya da anahtar iptal edilmiştir.
Model kullanılamıyor hatası — Model Kimliği, GET /v1/models yanıtında listelendiği biçimde yazılmamıştır. Kimlikler küçük harfli ve tireyle ayrılmıştır.
Tarayıcı konsolunda ağ veya CORS hatası — Uç Nokta URL'sinin https://api.kunavo.com olduğundan ve web sitesi alan adı olmadığından emin olun; CORS üstbilgilerini gönderen API ana bilgisayarıdır.

Sık sorulan sorular

TypingMind'da kendi API anahtarımla özel modeli nasıl eklerim?

Sol kenar çubuğunda Models bölümünü açın ve Add custom model, ardından Create Manually seçeneğine tıklayın. Name alanına bir ad, Model ID alanına modelin birebir kimliğini ve Context Length alanına bağlam uzunluğunu girin. Authentication sekmesinde API Type değerini seçin, tam Endpoint URL değerini yapıştırın — OpenAI uyumlu bir sağlayıcı için bu URL /v1/chat/completions ile biter — ve Authentication Type değerini API Key via HTTP Header olarak ayarlayın; Header Key alanına Authorization, Header Value alanına ise Bearer ve ardından anahtarınızı girin. Test & Save düğmesine tıklayın. Bu etiketler 2026-10-01 tarihinde canlı uygulamadan alındı; TypingMind'ın eski belgeleri aynı akışı biraz farklı ifadelerle açıklıyor.

TypingMind temel URL'yi mi, tam uç noktayı mı istiyor?

Tam uç noktayı. Alanın adı Uç Nokta URL'si'dir ve TypingMind belgelerindeki tüm ayrıntılı örneklerde https://api.minimax.io/v1/chat/completions gibi tam bir rota veya /anthropic/v1/messages ile biten bir Azure URL'si yapıştırılır. TypingMind bir yol eklemez; dolayısıyla tek başına https://api.kunavo.com/v1 gibi bir temel URL, isteği mevcut olmayan bir rotaya yönlendirir ve 404 döndürür.

TypingMind, Kunavo'yu doğrudan tarayıcıdan çağırabilir mi?

Evet; Kunavo'nun API'si 2026-09-29 tarihinde CORS üstbilgileri göndermeye başladı. TypingMind model isteklerini doğrudan web sayfasından gönderdiği için uç nokta, sayfanın origin'ine izin vermelidir. 2026-10-01 tarihinde typingmind.com'dan Kunavo'nun /v1/chat/completions, /v1/messages ve /v1/models uç noktalarına gönderilen istekler, okunabilir bir gövdeyle access-control-allow-origin: * döndürdü. Bu isteklerde bilerek geçersiz bir anahtar kullanıldı; dolayısıyla bunlar tarayıcı yolunun açık olduğunu kanıtlar, eksiksiz bir sohbetin çalıştırıldığını değil.

TypingMind proxy'sine veya TypingMind Cloud yönlendirmesine ihtiyacım var mı?

Kunavo için gerekmez. İstek Seçenekleri sekmesinde, form açıklamasına göre tarayıcı CORS kısıtlamalarını aşmak amacıyla istekleri TypingMind'ın sunucusu üzerinden yönlendiren İstekleri TypingMind Cloud üzerinden yönlendir seçeneği bulunur. Kunavo'nun API'si tarayıcı çağrılarına zaten izin verir; bu nedenle bu seçeneği kapalı bırakmak isteğin doğrudan tarayıcınızdan uç noktaya gitmesini sağlar.

Kunavo, TypingMind'ı baştan sona test etti mi?

Çalışan bir anahtarla test etmedi. 2026-10-01 tarihinde canlı Özel Model Ekle formu ve typingmind.com sayfasından Kunavo'ya gönderilen, geçersiz anahtar kullanan bir tarayıcı isteği kontrol edildi; bu istek CORS üstbilgileriyle okunabilir bir yanıt verdi. TypingMind üzerinden Kunavo'ya karşı hiçbir tamamlama, akış yanıtı veya araç çağrısı çalıştırılmadı ve Test Et ve Kaydet düğmesine basılmadı. Kendi Test Et ve Kaydet işleminizi ve ilk mesajınızı baştan sona kontrol olarak değerlendirin.