Dokümantasyon

twinny

twinny bir temel URL istemez. Bir protokol, ana bilgisayar adı, bağlantı noktası ve API yolu ister; sohbet için bu yol API temelidir — yani https, api.kunavo.com ve bağlantı noktası boş bırakılmış şekilde /v1.

twinny'de temel URL alanı yoktur — Add provider → OpenAI-compatible server, ardından Protocol https, Hostname api.kunavo.com, Port boş ve API path /v1; sohbet paneli anahtarınızla çalışır.

Sağlayıcılar sekmesi → Sağlayıcı ekle → OpenAI-compatible server

Label          Kunavo
Type           Chat
Provider       OpenAI-compatible server
Hostname       api.kunavo.com
Port           (leave blank — "Blank means the protocol's default")
Protocol       https
API path       /v1
Model name     claude-sonnet-5
FIM template   (Autocomplete only — not part of a Chat provider)
API key        sk-kn-...

API yolu /v1 olur, /v1/chat/completions olmaz. twinny'nin sağlayıcı tablosu bunu tek cümlede açıklığa kavuşturur — "Sohbet için yol API temelidir; twinny /chat/completions ekler" — bu nedenle rotayı zaten içeren bir yol /v1/chat/completions/chat/completions üretir ve 404 döner. Burada yanlış ayarlanabilecek tek bir temel URL alanı yoktur; ancak aynı tablo bir kısayol sunar: https://api.kunavo.com/v1 ifadesini Ana bilgisayar adı alanına yapıştırın; ifade "protokol, ana bilgisayar, bağlantı noktası ve yola ayrılır".

OpenAI veya Anthropic ön ayarı yerine genel OpenAI uyumlu sunucu ön ayarını seçin. twinny'nin barındırılan API'ler sayfası, sohbetin burada "satıcının SDK'sı üzerinden sabit uç noktasına gittiğini; bu nedenle ana bilgisayar adı, bağlantı noktası ve yol alanlarının gizlendiğini" belirtir — anahtar satıcıya gönderilir; bu, uç noktanızın bulunduğu yer değildir. Yukarıdaki alan etiketleri, sırasını koruyan provider-form tablosundaki etiketlerdir.

Kunavo, twinny'yi bu uç noktaya karşı çalıştırmadı. Bu sayfa twinny'nin kendi belgeleri ve Kunavo'nun rota tablosu temel alınarak hazırlanmıştır; yayımlanmış bir kurulum sayfası test değildir. Gerçek kanıtı sağlayan, twinny'nin Test provider düğmesidir — bu düğme "sağlayıcının işi için küçük bir istek gönderir ve çağırdığı URL ile birlikte başarıyı veya sunucunun döndürdüğü hatayı gösterir".

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

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
Kenar çubuğunun üst kısmındaki robot simgesinden Providers sekmesini açın veya komut paletinden Manage twinny providers komutunu çalıştırın.
Add provider → On your machine altında OpenAI-compatible server, yani tüm durumlar için kullanılan ön ayarı seçin. Bu ayar başlangıçta localhost:8080 adresine yöneltilmiş olarak gelir.
Protocol alanını https, Hostname alanını api.kunavo.com olarak ayarlayın, Port alanını temizleyin ve API path alanını /v1 olarak ayarlayın. Type alanını Chat olarak bırakın.
Anahtarı API key alanına yapıştırın — twinny anahtarı Authorization: Bearer olarak gönderir. Ardından Model name alanını ayarlayın; bunu elle yazabilir veya Choose from the server's models seçeneğini kullanabilirsiniz, çünkü Kunavo GET /v1/models yanıtını verir.
Test provider düğmesine, ardından etkin sohbet sağlayıcısı yapmak için Use this provider düğmesine basın. Dört uç nokta alanını yeniden yazmak yerine ikinci bir model için satırı kopyalamak üzere Copy seçeneğini kullanın.

twinny'nin Other local servers 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 twinny ve Continue karşılaştırması 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 twinny 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ış	twinny içinde kullanım alanı
`claude-sonnet-5`	$1.40 / $7.00	sohbet paneli, satır içi düzenleme ve kod incelemesi — çalışan varsayılan
`claude-haiku-4-5`	$0.70 / $3.50	işleme mesajları, terminal yardımcıları ve kod eylemleri; hacmin belirleyici olduğu alanlar
`gpt-5-6-terra`	$0.70 / $4.20	sohbete yapıştırılan uzun dosyalar ve bir inceleme yüzeysel kaldığında başka bir model ailesinden 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.

Sohbet çalışır. Otomatik tamamlama ve dizin çalışmaz.

twinny çalışmayı üç sağlayıcı türüne böler ve her biri ayrı yapılandırılır — bu nedenle "twinny Kunavo ile çalışır" ifadesi yalnızca bunlardan biri için doğrudur. Diğer ikisi henüz bulamadığınız bir yapılandırma değildir; ihtiyaç duydukları rotalar Kunavo'nun yanıtladığı rotalar değildir.

Sağlayıcı türü	twinny'nin gönderdiği	api.kunavo.com'a karşı
Sohbet	`<API path>/chat/completions` adresine OpenAI biçimli POST	Uygun — bu, yukarıdaki sayfadır.
Otomatik tamamlama (FIM)	`/v1/completions` adresine ham bir ortadan doldurma istemi	Hayır. Kunavo'da /v1/completions rotası ve bunu çalıştıracak bir temel veya kod modeli yoktur.
Gömmeler	`/v1/embeddings` adresine bir istek	Hayır. Kunavo herhangi bir embedding modeli sunmaz; bu nedenle çalışma alanı dizini burada oluşturulamaz.

Bu iki eksiklik kurulumu engellemez; çünkü twinny her tür için bir etkin sağlayıcı tutar ve bu sağlayıcılar birbirinden bağımsızdır. Kendi barındırılan API sayfası bu ayrımı "yaygın bir kurulum" olarak adlandırır: sohbet, inceleme ve düzenlemeler için barındırılan bir modelin yanında tamamlama için küçük bir yerel temel model. Çalışma alanı dizini de aynı yapıdadır — embedding adımı burada sunulmaz ve twinny'nin belgeleri bunun yerine Ollama üzerinde nomic-embed-text gibi bir yerel model kullanılmasını önerir. Farklı modellerden gelen vektörler birleştirilemez; bu nedenle modeli değiştirmek bir güncelleme değil, dizinin yeniden oluşturulmasını gerektirir.

Sık sorulan sorular

twinny'yi özel bir API uç noktasına nasıl yönlendiririm?

twinny kenar çubuğundaki robot simgesinden Providers sekmesini açın, Add provider seçeneğini belirleyin ve "On your machine" altında "OpenAI-compatible server" adlı tüm durumlar için kullanılan ön ayarı seçin. twinny'nin belgeleri, sağlayıcı formunun herhangi bir ana bilgisayar adı, bağlantı noktası, protokol ve yolu kabul ettiğini belirtir; bu nedenle Protocol alanını https, Hostname alanını uç noktanızın ana bilgisayarı olarak ayarlayın, protokolün varsayılanını kullanmak için Port alanını boş bırakın ve API path alanını API temeli olarak ayarlayın. Anahtarınızı API key alanına yapıştırın; twinny bunu Authorization: Bearer başlığı olarak gönderir. Ardından Test provider düğmesine basın — düğme o sağlayıcının işi için küçük bir istek gönderir ve sunucunun döndürdüğü hatayla birlikte başarıyı veya hatayı, çağırdığı URL ile beraber bildirir.

twinny'nin API yolu /v1 mi yoksa /v1/chat/completions mı olmalı?

Sohbet sağlayıcısı için /v1 olmalıdır. twinny'nin sağlayıcı tablosunda "Sohbet için yol API temelidir; twinny /chat/completions ekler" denir; yani uzantı tam rotayı kendisi oluşturur ve bunu zaten içeren bir yol /v1/chat/completions/chat/completions olarak çözümlenir; sonuç kimlik doğrulama hatası değil, 404 olur. Aynı formdaki otomatik tamamlama ve embedding'ler bunun tersini kullanır: burada API yolu, genel ön ayarın varsayılanlarında /v1/completions ve /v1/embeddings olduğu gibi tam rotadır.

twinny API anahtarı nereye gider ve bir temel URL alanı var mı?

Anahtar, sağlayıcının API key alanına girer ve Authorization: Bearer olarak gönderilir; twinny'nin belgeleri anahtarların VS Code depolamasında sağlayıcıyla birlikte saklandığını ve twinny günlüklerinden çıkarıldığını belirtir. Tek bir temel URL alanı yoktur — uç nokta Protocol, Hostname, Port ve API path alanlarına bölünür. Kısayol şudur: Hostname alanına tam bir URL yapıştırmak çalışır. Belgeler, https://my-box:8080/v1 gibi yapıştırılmış bir URL'nin protokol, ana bilgisayar, bağlantı noktası ve yola ayrıldığını belirtir; dolayısıyla https://api.kunavo.com/v1 yapıştırıldığında üç alan aynı anda doldurulur.

twinny'nin otomatik tamamlaması Kunavo gibi barındırılan bir ağ geçidi üzerinden çalışabilir mi?

Hayır; nedeni bir ayar değil, eksik bir rotadır. twinny'nin genel OpenAI uyumlu ön ayarı, ham bir ortadan doldurma istemini /v1/completions tarzı bir rotaya gönderir ve api.kunavo.com /v1/completions sunmaz; katalogda da ortadan doldurma için eğitilmiş bir temel veya kod modeli yoktur. Otomatik tamamlamayı yerel bir sunucuda tutun — twinny'nin SSS bölümü Ollama üzerinde qwen2.5-coder:1.5b-base modelini önerir — ve barındırılan sağlayıcıyı sohbet için kullanın. twinny bu birleşime yaygın bir kurulum der; etkin sağlayıcı türe göre seçildiğinden geçiş yapmanız gerekmez.

Kunavo, twinny'nin çalışma alanı dizinini çalıştırabilir mi?

Hayır. Çalışma alanı dizini dosyalarınızı bir Embeddings sağlayıcısıyla gömer ve Kunavo herhangi bir embedding modeli sunmaz — kataloğundaki hiçbir model bu uç noktayı taşımaz; bu nedenle istek yanıtlanmak yerine reddedilir. twinny'nin kendi belgeleri bu iş için makinenizde çalışan Ollama üzerindeki nomic-embed-text modelini önerir; bu model sohbeti sunan sağlayıcıdan bağımsızdır. Bu, engellenmiş değil, bölünmüş bir yapılandırmadır; embedding modelini daha sonra değiştirirseniz yeniden oluşturma gerekir, çünkü farklı modellerden gelen vektörler birleştirilemez.

Neden Kunavo anahtarıyla twinny'nin OpenAI veya Anthropic ön ayarını kullanmayalım?

Çünkü bu ön ayarlar isteği düşündüğünüz yere göndermez. twinny'nin barındırılan API'ler sayfası, barındırılan bir API ile sohbetin satıcının SDK'sı üzerinden sabit uç noktasına gittiğini ve bu nedenle ana bilgisayar adı, bağlantı noktası ve yol alanlarının gizlendiğini belirtir — yapıştırdığınız anahtar ağ geçidinize değil, satıcının kendi uç noktasına gider. Uç nokta alanlarının düzenlenebilir kalmasını sağlayan ön ayar genel "OpenAI-compatible server" ön ayarıdır; yukarıda bu ön ayarın adı bu nedenle verilmiştir. Model kimlikleri yapılandırdığınız uç noktaya aktarılır; dolayısıyla OpenAI uyumlu bir sağlayıcıda Claude kimliği kullanmak bir uyuşmazlık değil, amaçlanan birleşimdir.

Kunavo twinny'yi test etti mi?

Hayır. Kunavo bu istemciyi çalışma zamanında test etmedi; yukarıdaki yapılandırma twinny'nin 21 Eylül 2026 tarihinde kontrol edilen kendi belgeleri ile Kunavo'nun rota tablosundan alınmıştır. Yayımlanmış bir kurulum sayfası test değildir. Ücretsiz olarak yapabileceğiniz kontrol, çağırdığı URL'yi ve sunucunun yanıtını bildiren twinny'deki Test provider düğmesidir; ayrıca /v1/models adresine gönderilen tek bir curl isteği, hatanın uç noktaya mı, anahtara mı yoksa forma mı ait olduğunu kesinleştirir.