Dify

Tek zorunlu alan — OpenAI-API-compatible eklentisinin Add Model formundaki API Base URL — bir Dify çalışma alanındaki her LLM düğümünü Kunavo'ya yönlendirir.

# Integrations → Model Provider → OpenAI-API-compatible → Add Model
Type                          LLM
Model Name                    claude-sonnet-5
Model display name            Kunavo · Claude Sonnet 5
API Key                       sk-kn-...
API Base URL                  https://api.kunavo.com/v1
model name for API endpoint   (leave blank — Model Name is already the id)
Completion mode               Chat
Model context size            1000000
Upper bound for max tokens    (your own ceiling for one reply)
Function Call Type            Tool Call     # defaults to no_call
Vision Support                Support       # only if you will send images
Structured Output             Support       # defaults to not supported

# Model context size is per model, not per endpoint: 1000000 is
# claude-sonnet-5's. The table below carries the rest.

Adım adım

1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
2. Dify'de Integrations → Model Provider bölümünü açın, Install model providers (veya Marketplace) bölümüne göz atıp langgenius tarafından yayımlanan OpenAI-API-compatible eklentisini yükleyin. Dify belgelerine göre sağlayıcıları yalnızca çalışma alanı sahibi ve yöneticiler yönetebilir.
3. Bu sağlayıcının kartında Add Model'e tıklayın. Eklentide önceden tanımlanmış model yoktur; bu bir customizable-model sağlayıcısıdır. Bu nedenle istediğiniz her kimlik için ayrı bir kayıt oluşturmanız gerekir.
4. Formu yukarıda gösterildiği gibi doldurun. Type = LLM, Model Name = Kunavo kimliğinin aynısı, API Key = sk-kn- anahtarınız, API Base URL = https://api.kunavo.com/v1, Completion mode = Chat ve Model context size = aşağıdaki tablodaki değer. Ardından Function Call Type'ı, gerekiyorsa Structured Output ve Vision Support ayarlarını yapın. Kaydedin.
5. Bir iş akışı açın ve modeli kullanması gereken düğümde seçin. Dify modelleri uygulama başına değil, düğüm başına atar; böylece sınıflandırıcı ve son metni oluşturan düğüm farklı kimlikleri ve farklı fiyatları kullanabilir. Model seçilmeyen uygulamalar ve düğümler Default Models → System Reasoning Model ayarına geri döner.
6. Sınırları belli bir iş akışı çalıştırın, ardından ücreti Dify'de değil Kunavo hesabınızda kontrol edin. Maliyet gösterimiyle ilgili aşağıdaki nota bakın.

Dify'nin OpenAI-API-compatible eklenti 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.

İ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 Dify 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ış.

“Dify API” adı iki farklı şeyi ifade eder

Bu sayfa bunlardan birini anlatıyor; arama sonuçlarında bu ikisi sürekli birbirine karıştırılıyor.

1. Dify'ye model eklemek — yukarıdaki kurulum bölümünün anlattığı budur. İstemci Dify, uç nokta Kunavo'dur ve girdiğiniz kimlik bilgisi bir sk-kn- anahtarıdır. Böylece o çalışma alanındaki her uygulamanın her LLM düğümü, eklediğiniz kimliklere erişebilir.
2. Kendi kodunuzdan bir Dify uygulamasını çağırmak — Dify'nin yayımlanmış bir uygulama için sunduğu Service API; bu API için Dify tarafından verilen ayrı bir app- anahtarı kullanılır. Bu anahtar Dify'nindir, bizim değil; başka bir yere yönlendiremezsiniz. Bu yöndeki işlemlerde Kunavo'nun rolü yoktur.

İkisi aynı uygulamada aynı anda çalışabilir ve genellikle de çalışır: arka ucunuz Dify uygulamasını Dify anahtarıyla çağırırken uygulamanın düğümleri Kunavo'yu Kunavo anahtarıyla çağırır. İki anahtar, iki fatura; bir şey 401 hatası verdiğinde kontrol edilecek iki yer.

Dify neden eklediğiniz modelin maliyetini göstermiyor?

Dify'nin birinci taraf, önceden tanımlanmış model dosyalarında fiyatlandırma bloğu bulunur: girdi ve çıktı ücretleri ile token başına birim. Dify, günlüklerde bir tutar göstermek için token sayılarını bu ücretlerle çarpar. Yukarıda belirtilen tarihte incelenen OpenAI-API-compatible sağlayıcı şemasında fiyat, birim veya para birimi alanı tanımlanmamıştır. Dolayısıyla bu eklenti üzerinden eklenen bir model için Dify'nin çarpacağı bir ücret yoktur. Maliyet sütununun boş olması, bulduğunuz bir indirim ya da sizin neden olduğunuz bir hata değildir; böyle bir alan hiç yoktur. Gerçek tutarı Kunavo kullanımınızdan, Dify'nin gösterdiği değerleri ise token sayısı olarak alın.

Açık bırakmanız gereken bir ayar daha var: Include Usage in Stream varsayılan olarak etkindir ve son akış parçasında istem ve tamamlama token sayılarını uç noktadan ister. Bunu kapatırsanız token sayılarını da kaybedersiniz.

Dify'yi kendi sunucunuzda barındırıyorsanız

Docker Compose yığını, giden istekleri bir ssrf_proxy hizmeti üzerinden yönlendirir. Bu nedenle uç noktaya yalnızca dizüstü bilgisayarınızdaki tarayıcıdan değil, kapsayıcı ağının içinden de erişilebilmesi gerekir. Bir yerde çalışıp diğerinde zaman aşımına uğrayan yapılandırma genellikle bu sorundan kaynaklanır; konu kimlik bilgileri değil ağdır. Kapsayıcının içinden çalıştırılan yukarıdaki curl, bunu doğrudan yanıtlar.