Dokümantasyon

Dyad

Dyad, Add Custom Provider üzerinden tüm OpenAI uyumlu uç noktaları kabul eder: üç alanı doldurun, sağlayıcının sayfasında bir anahtar belirleyin ve model seçicide istediğiniz her model kimliği için bir satır ekleyin.

Dyad, Settings → AI Providers → Add Custom Provider üzerinden her OpenAI uyumlu uç noktayı alır: API Base URL https://api.kunavo.com/v1, sağlayıcının kendi sayfasındaki anahtar ve ardından model kimliği başına bir Add Custom Model satırı.

Ayarlar → AI Sağlayıcıları → Özel Sağlayıcı Ekle

Settings → AI Providers → Add Custom Provider
  ID                  kunavo
  Display Name        Kunavo
  API Base URL        https://api.kunavo.com/v1

Then on the new provider's own page
  Set Kunavo API Key  sk-kn-...            → Save Key

Provider page → bottom → Add Custom Model
  Model ID            claude-sonnet-5
  Name                Claude Sonnet 5 (Kunavo)
  Description         Kunavo, OpenAI-compatible
  Max Output Tokens   128000
  Context Window      1000000

Temel URL'de /v1 bulunmalıdır; ancak bunun nedeni belgelerde yazması değildir. Özel modeller sayfasında yalnızca “API Base URL'yi genellikle sağlayıcının belgelerinde bulabilirsiniz” ifadesi yer alır; örnek verilmediğinden soruyu yanıtlamaz. Uygulamanın yayımlanmış sürümündeki iki unsur yanıtı verir: iletişim kutusundaki yer tutucu E.g., https://api.example.com/v1 şeklindedir ve özel sağlayıcı, girdiğiniz değer baseURL olarak değiştirilmeden kullanılarak OpenAI uyumlu bir istemci olarak oluşturulur. Dyad yolu ekler, /v1'ı değil. Dyad'ın kendi içinde sabit kodlanmış her OpenAI uyumlu uç noktası aynı şekilde biter. Bu kısım olmadan verilen temel URL, reddedilen bir anahtar hatası değil, 404 hatası verir.

Belgeler sayfasında bulunmayan iki alan daha vardır. Uygulamanın yayımlanmış iletişim kutusunda ilk alanın adı Provider ID'dir, ID değil; ayrıca Environment Variable (Optional) alanı eklenmiştir. Bu alana KUNAVO_API_KEY gibi bir değişken adı girilir ve yalnızca ayarlarda anahtar kayıtlı değilse okunur. Anahtarın kendisi bu iletişim kutusunda hiçbir yerde yer almaz: önce sağlayıcıyı oluşturun, sonra sayfasını açıp Set Kunavo API Key kutusunu kullanın.

Context Window alanını doldurun, boş bırakmayın. Dyad'ın tek uyarısı, boş alanların “en uygun değerden küçük olabilecek varsayılan değerleri” kullanmasıdır. Uygulamanın yayımlanmış varsayılanı 128.000 token'dır ve Dyad bir görüşmeyi, sağlayıcıya özel üst sınır ile bağlam pencerenizden 25.000 çıkarılarak bulunan değerden düşük olanına ulaşıldığında sıkıştırır. Özel sağlayıcı custom:: kimliği altında saklanır; dolayısıyla Google veya OpenAI üst sınırına değil, 250.000 üst sınırına tabi olur. Alanı boş bırakırsanız, milyon token'lık bir model 250.000 yerine 103.000 token'da özetlemeye başlar; aynı iş için gereksiz yere daha fazla sıkıştırma turu yapılır.

Bu yapılandırma, aşağıda belirtilen tarihte Dyad'ın kendi belgeleri ve yayımlanmış kaynak kodu incelenerek hazırlandı. Kunavo, Dyad'ı kendi uç noktasında çalıştırmadı — derleme, akışlı düzenleme veya Agent modunda araç gidiş-dönüşü yapılmadı. Aynı durum bu ailedeki tüm istemciler için geçerlidir. Yayımlanmış bir kurulum sayfası uyumluluk testi değildir. Bunu denerken mevcut çalışan yolunuzu kullanıma hazır tutun ve bir projeyi bu yola taşımadan önce sınırları belli bir özelliği çalıştırın.

Kunavo embedding, metin okuma veya konuşmayı metne dönüştürme modeli sunmadığından, bu şekilde eklenen özel sağlayıcı yalnızca sohbet tamamlamalarını yanıtlar. Dyad'ın derleme döngüsü diğer üç modeli istemez; dolayısıyla burada özellik kaybı yaşamazsınız. Bu yalnızca eklediğiniz sağlayıcının, bu üç modeli de gerektiren bir teknoloji yığını için doğrudan kullanılabilecek bir alternatif olmadığı anlamına gelir.

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

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
Dyad'da Settings bölümüne gidin, AI Providers kısmını bulun ve Add Custom Provider'a tıklayın. ID, Display Name ve API Base URL alanlarını yukarıda gösterildiği gibi doldurun. ID “dahili olarak kullanılır ve sonradan değiştirilemez”; bu nedenle uygun bir değer seçin. Display Name, model seçicide görünen addır ve yalnızca görsel amaç taşır.
Yeni oluşturduğunuz sağlayıcıyı açıp anahtarı Set Kunavo API Key alanına yapıştırın, ardından Save Key'e tıklayın. Temel URL'yi boş bırakırsanız Dyad isteği ağ hatasıyla değil, doğrudan missing the API Base URL hatasıyla reddeder.
Aynı sayfada aşağıya kaydırıp Add Custom Model seçeneğine tıklayın. Model ID katalogdaki kısa adla birebir aynı olmalıdır. Dyad belgelerinde bu değer “sağlayıcının API belgelerinde belirtilenle tam olarak aynı olmalıdır. API'ye gönderilen tanımlayıcı budur” denmektedir. Bu nedenle görünen adı değil, claude-sonnet-5 tanımlayıcısını kullanın.
Max Output Tokens ve Context Window alanlarını boş bırakmak yerine /models'daki değerlere göre doldurun. Ardından seçicide bulunmasını istediğiniz her kimlik için Add Custom Model işlemini tekrarlayın. Toplu içe aktarma veya listeleri otomatik getirme özelliği yoktur.
Model seçicide yeni modeli belirleyip gerçek bir görev verin; örneğin selamlama yerine eklenecek bir bileşen isteyin. Build modu, her adımda mevcut çalışma kümesini yeniden gönderen bir Agent döngüsüdür. Bu nedenle ilk çalıştırmada akış ve yinelenen düzenlemeler denenmelidir.

Dyad'ın Custom Models 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 Dyad fiyatlandırma ve API maliyet rehberi 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 Dyad 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ış	Dyad içinde kullanım alanı
`claude-sonnet-5`	$1.40 / $7.00	gün boyu çalışan döngüde dolar başına kodlama kalitesi sunan varsayılan Build modu modeli
`claude-opus-5`	$3.50 / $17.50	yanlış planın oturuma mal olacağı yeniden düzenleme işlerinde Plan modu
`claude-haiku-4-5`	$0.70 / $3.50	hacmin belirleyici olduğu Ask modu ve kod tabanıyla ilgili hızlı sorular
`gpt-5-6-sol`	$2.00 / $12.00	aynı sağlayıcıya ikinci bir özel model olarak eklenmiş, başka bir model ailesinden ikinci görüş
`gpt-5-6-terra`	$0.70 / $4.20	Context Window alanı doğru biçimde doldurulduğunda geniş bir çalışma kümesi

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.

Geçiş yapmadan önce bilmeniz gereken üç sınır

Bunlar Kunavo'nun değil, Dyad'ın kendi kurallarıdır ve her biri müşteri anahtarının erişebileceği alanı değiştirir. Bu nedenle bu sayfada Dyad'ın tamamına değil, modellere giden bir yol anlatılıyor.

Pro modlarına tasarım gereği kendi anahtarınızla erişemezsiniz. Dyad'ın fiyatlandırma SSS'sinde bu net biçimde yanıtlanır: Smart Context gibi Pro modları yalnızca Dyad Pro'nun AI kredileriyle kullanılabilir, kendi API anahtarlarınızla kullanılamaz; çünkü bu modlarda sunucu tarafında birden fazla model üzerinden işlem gerekir. Turbo Edits de bu kapsamdadır. Özel sağlayıcı modellere ve standart modlara erişim sağlar, bu mekanizmalara değil.
Ücretsiz planda Agent modunun kullanımı sınırlıdır. Üst sınır, 23 saatlik zaman aralığında 20 Agent mesajıdır ve hangi anahtarı yapılandırdığınızdan bağımsız olarak geçerlidir; Build, Ask ve Plan için üst sınır yoktur. Bu nedenle oturum ortasında beklenmedik bir duraklama yaşarsanız, sebep bakiyeniz veya uç noktanız değil, Dyad kotası olabilir.
Anthropic Messages protokolüne Dyad'dan erişilemez. Özel sağlayıcılar her zaman OpenAI chat-completions istemcisi olarak oluşturulur; yerleşik Anthropic sağlayıcısı ise temel URL geçersiz kılma seçeneği sunmaz. Dolayısıyla Claude modellerine burada OpenAI uyumlu arayüz üzerinden erişilir. Yukarıdaki kurulum da bunu yapar ve bu sayfadaki doğrulama isteğinin OpenAI biçiminde olmasının nedeni budur.

Sık sorulan sorular

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

Settings'e gidin, AI Providers bölümünü bulun ve Add Custom Provider'a tıklayın. Dahili olarak kullanılan ve sonradan değiştirilemeyen bir ID, model seçicide görünecek Display Name ve uç noktanızın API Base URL değerini girin. Kaydedin, ardından yeni oluşturduğunuz sağlayıcıyı açıp anahtarınızı sayfasındaki "Set <name> API Key" kutusuna yapıştırın; anahtar oluşturma iletişim kutusunda yer almaz. Son olarak sayfanın altına kaydırın ve erişilebilir olmasını istediğiniz her model kimliği için Add Custom Model işlemini bir kez yapın. Dyad belgelerinde uç nokta gereksinimi tek cümleyle belirtilir: OpenAI uyumlu API sunduğu sürece herhangi bir sağlayıcı çalışır.

Dyad API Base URL sonunda /v1 gerektiriyor mu?

OpenAI uyumlu bir uç nokta için evet; örneğin https://api.kunavo.com/v1. Dyad'ın Custom Models belgeleri bu soruyu yanıtlamaz: yalnızca API Base URL'yi genellikle sağlayıcının belgelerinde bulabileceğinizi söyler ve örnek vermez. Yanıtı iletişim kutusunun kendisi verir; yer tutucusu "E.g., https://api.example.com/v1" şeklindedir. Dyad istemciyi de bu şekilde oluşturur: verdiğiniz değer, OpenAI uyumlu istemcinin baseURL değeri olarak değiştirilmeden kullanılır ve yalnızca yol eklenir. /v1 içermeyen temel URL, kimlik doğrulama hatası yerine 404 verir; /chat/completions içeren bir URL de aynı şekilde başarısız olur.

Anthropic hesabım olmadan Dyad'ı Claude modelleriyle kullanabilir miyim?

Evet, Dyad'ın yerleşik Anthropic kaydı yerine özel sağlayıcı üzerinden kullanabilirsiniz. Dyad her özel sağlayıcıyı OpenAI chat-completions istemcisi olarak oluşturur. Bu nedenle yazdığınız model kimliği uygulamada değil, yapılandırdığınız uç noktada çözümlenir ve buraya bir Claude kimliği gönderebilirsiniz. Yardımcı olamayacak seçenek yerleşik Anthropic sağlayıcısıdır: temel URL bağımsız değişkeni olmadan oluşturulur; dolayısıyla ANTHROPIC_BASE_URL benzeri bir geçersiz kılma seçeneği yoktur ve istekler yalnızca Anthropic'in kendi uç noktasına gider.

Dyad'daki özel sağlayıcı ile OpenRouter kullanmak arasında fark var mı?

Fark yalnızca kurulum biçimindedir. Dyad'ın sağlayıcı listesinde yerleşik ön ayarı bulunan tek bağımsız, çok sağlayıcılı ağ geçidi OpenRouter'dır; bu nedenle yalnızca anahtar gerekir. Diğer tüm ağ geçitleri Add Custom Provider üzerinden eklenir; bu yöntemde her modelin kimliği, Max Output Tokens ve Context Window değerleri de elle girilir. Bir ağ geçidinin ön ayar olarak eklenmesi istendiğinde Dyad'ın bakım sorumlusu tam olarak bu yolu göstermiştir. İkisini listedeki logolarına göre değil, fiyat, bakiye yükleme koşulları ve gerçekten istediğiniz modeller açısından karşılaştırın.

Dyad özel modelim neden konuşmayı bu kadar erken özetlemeye başlıyor?

Bunun nedeni muhtemelen Context Window alanını boş bırakmış olmanızdır. Dyad, alan boş olduğunda 128,000 token varsayılan değerini kullanır ve sağlayıcıya özel üst sınır ile bağlam penceresinden 25,000 çıkarılarak bulunan değerden düşük olana ulaşıldığında içeriği sıkıştırır. Özel sağlayıcı için Google veya OpenAI üst sınırı değil, 250,000 üst sınırı geçerlidir. Dolayısıyla alan boşsa, penceresi çok daha büyük bir modelde bile sıkıştırma yaklaşık 103,000 token'da başlar. Sağlayıcının kataloğundaki gerçek değerleri Max Output Tokens ve Context Window alanlarına girerseniz eşik üst sınıra yükselir.