Neler Oluşturacaksınız
Hangi API hizmeti, her sağlayıcıyı ayrı ayrı kurmadan Dify'a daha fazla yapay zeka modeli eklemenizi sağlar? CometAPI pratik bir seçenektir. Dify model eklentisini bir kez kurun, bir CometAPI anahtarını kaydedin ve aynı Dify çalışma alanında OpenAI, Anthropic, Google ve DeepSeek modellerini kullanın.
Tek Anahtar, Tek Model Yapılandırması Anlamına Gelmez: CometAPI kimlik doğrulamayı ve API erişimini merkezileştirir, ancak Dify'nın her LLM düğümünün hangi modeli çağıracağını bilmesi gerekir. Bu nedenle, aynı sağlayıcı bağlantısı altında birden fazla model kimliği yapılandırabilirsiniz.
Bu kılavuzun sonunda, tek bir sağlayıcı bağlantısı altında Dify tarafından kullanılabilir dört metin modeliniz olacak. Ayrıca Dify dışında aynı uç noktayı ve anahtarı kullanan küçük bir Python smoke testi de olacak; bu, bir Dify yapılandırma sorununu bir API sorunundan ayırmayı kolaylaştırır.
Sağlayıcı bağlantısı kaydedildikten sonra, her model kimliğini ayrı bir seçilebilir yapılandırma olarak ekleyin veya etkinleştirin. Bu, kimlik doğrulama ve faturalandırma bağlantısı paylaşımlı kalırken model özelindeki yetenekleri, sınırlamaları ve yönlendirme kararlarını görünür tutar.
Başlamadan Önce
Model eklentileri kurabildiğiniz bir Dify çalışma alanına, bir CometAPI API anahtarına ve güncel model kimliklerine ihtiyacınız var. Anahtarı Dify'nın kimlik bilgisi deposunda veya sunucu tarafı gizlisi olarak saklayın; bir genel depoya, tarayıcı paketine, ekran görüntüsüne veya paylaşılan iş akışı dışa aktarımına koymayın.
OpenAI ile uyumlu temel URL https://api.cometapi.com/v1. CometAPI Dify eklentisi bu uç noktayı dahili olarak ayarlar. Bunun yerine Dify'nın genel OpenAI API ile uyumlu sağlayıcısını kullanırsanız, aynı temel URL'yi manuel olarak girin.
Tek Bir API Anahtarıyla Dify'a Birden Fazla Yapay Zeka Modeli Ekleyebilir misiniz?
Evet. Bir CometAPI sağlayıcı bağlantısı, Dify'nın OpenAI, Anthropic, Google, DeepSeek ve diğer sağlayıcılardan desteklenen modeller için tek bir kimlik bilgisini yeniden kullanmasına olanak tanır. Yine de her LLM düğümünün hangi rotayı çağıracağını bilmesi için her model kimliğini ayrı ayrı yapılandırırsınız; ancak her model ailesi için farklı bir üst akış kimlik bilgisi ve faturalandırma hesabını sürdürmeniz gerekmez.
Her Sağlayıcıyı Doğrudan Bağlamak Yerine Neden CometAPI Kullanmalı?
CometAPI, uyumlu sohbet iş yüklerine tek bir temel URL, tek bir API anahtarı ve tek bir kullanım hesabı sağlayarak entegrasyon yükünü azaltır. Bu, Dify içinde model değerlendirmeyi ve geçişi kolaylaştırır; model özelindeki seçimleri görünür tutar. Yine de yalnızca sağlayıcının sunduğu bir özellik, sözleşme, bölgesel dağıtım veya destek düzenine ihtiyaç duyduğunuzda doğrudan sağlayıcı bağlantıları tercih edilebilir; bu nedenle iş akışınızın gerektirdiği tam model yeteneklerini test edin.
Dify'a Hangi Modelleri Ekleyebilirsiniz?
| Model ailesi | CometAPI model kimliği | CometAPI yayımlanma (UTC) | Güncel fiyatlandırma |
|---|---|---|---|
| OpenAI | gpt-5.6 | 9 Temmuz 2026 | Güncel fiyatlandırmayı görüntüle |
| Claude | claude-opus-5 | 24 Temmuz 2026 | Güncel fiyatlandırmayı görüntüle |
| Gemini | gemini-3.7-flash | 13 Ağustos 2026 | Güncel fiyatlandırmayı görüntüle |
| DeepSeek | deepseek-v4-flash | 12 Ağustos 2026 | Güncel fiyatlandırmayı görüntüle |
Yukarıdaki güncel kimlikler ve CometAPI yayımlanma tarihleri, 26 Ağustos 2026'da genel katalog API'si ile doğrulanmıştır. Statik kalabilecek bir ücreti kopyalamak yerine, her bir bağlantılı CometAPI model sayfasını dinamik fiyatlandırma kaynağı olarak kullanın. Kullanılabilirlik, modaliteler ve Dify eklenti desteği de değişebilir; bu nedenle dağıtımdan önce hesabınızdaki tam modeli doğrulayın.
CometAPI'yi Dify'a Nasıl Bağlarsınız
Adım 1 — CometAPI model eklentisini kurun
Dify'nin Marketplace veya Eklentiler bölümünü açın ve CometAPI'yi arayın. CometAPI model sağlayıcı eklentisini yükleyin. Dify Cloud ve kendi barındırdığınız sürümlerde tam gezinme etiketleri değişebilir; sabit bir menü yoluna güvenmek yerine eklentinin güncel yapılandırma ekranını kullanın.
Adım 2 — CometAPI sağlayıcısını yapılandırın
CometAPI eklentisinin güncel yapılandırma ekranını açın, CometAPI anahtarınızı yapıştırın ve sağlayıcı kimlik bilgisini kaydedin. Dify bunu küçük bir model isteğiyle doğrulayabilir. Eklenti, uyumlu sohbet iş yüklerini https://api.cometapi.com/v1 üzerinden yönlendirir; dolayısıyla ayrı OpenAI, Anthropic, Google ve DeepSeek kimlik bilgilerine gerek yoktur.
Dify dağıtımınız CometAPI eklentisini kuramıyorsa, resmi OpenAI-API-compatible model sağlayıcısını kurun. Her modeli Chat modunda bir LLM olarak ekleyin, aynı CometAPI anahtarını yeniden kullanın ve API Base URL alanını https://api.cometapi.com/v1. olarak ayarlayın. Bu yedek yol, model başına bir özel giriş oluşturmanızı ister; ancak yine de ayrı sağlayıcı hesaplarını önler.
Adım 3 — Dört model kimliğini ekleyin
CometAPI sağlayıcısına dönün ve model listesindeki dört kimliği arayın. Bir kimlik önceden tanımlıysa, etkinleştirin. Yüklü eklenti sürümünüzde henüz görünmüyorsa, sağlayıcının özel model seçeneğini seçin ve yukarıdaki tablodaki güncel kimliği olduğu gibi girin. Completion mode değerini Chat olarak bırakın.
Dify özel bir model için bağlam boyutu istediğinde, varsayılanı tahmin etmek yerine doğrulanmış değeri kullanın. Multimodal anahtarlar için, canlı katalogda gösterilen yetenekleri yalnızca etkinleştirin. Bir model, başka bir modele aynı şekilde görüntüler, araçlar, yapılandırılmış çıktı veya akıl yürütme kontrollerini desteklemese bile Chat Completions'ı destekleyebilir.
Adım 4 — Dify uygulamanızda bir model seçin
Dify Studio'da bir Chatflow, Workflow, Agent veya sohbet botu açın. Bir LLM düğümü ekleyin, sağlayıcı olarak CometAPI'yi seçin ve yapılandırılmış model kimliklerinden birini seçin. “Model ailesini bir cümlede yanıtla” gibi kısa bir istem kullanın, ardından düğümü çalıştırın. Diğer üç modelle tekrarlayın. Yalnızca seçili model kimliği değişir; sağlayıcı kimlik bilgisi aynı kalır.
Bağlantı Python ile Nasıl Test Edilir
Aynı dört rotayı Dify'ı dahil etmeden önce kontrol etmek için bu bağımsız smoke testini kullanın. OpenAI Python SDK'sını kurun, ortamınıza COMETAPI_KEY ekleyin ve betiği güvenilir bir makineden çalıştırın. Başarılı bir sonuç anahtarı, uç noktayı ve güncel model kimliklerini doğrular; bu, gerçek Dify iş akışındaki testin yerine geçmez.
import osfrom openai import OpenAIMODELS = { "OpenAI": "gpt-5.6", "Claude": "claude-opus-5", "Gemini": "gemini-3.7-flash", "DeepSeek": "deepseek-v4-flash",}client = OpenAI( api_key=os.environ["COMETAPI_KEY"], base_url="https://api.cometapi.com/v1", timeout=30.0, max_retries=2,)for family, model in MODELS.items(): try: response = client.chat.completions.create( model=model, messages=[ {"role": "user", "content": "Reply with one short sentence."} ], ) text = response.choices[0].message.content or "" print(f"{family}: OK | {response.model} | {text[:80]}") except Exception as error: print(f"{family}: ERROR | {type(error).__name__} | {error}")
Bu testi Dify iş akışınızın dışında tutun. Görevi anahtarı, uç noktayı ve model kimliğini doğrulamaktır. Bir model burada başarılı olduktan sonra, Dify tarafındaki bir başarısızlık büyük olasılıkla eklenti yapılandırmasından, model yetenek ayarlarından veya bizzat iş akışından kaynaklanır.
Dağıtımdan Önce Model Kullanılabilirliği Nasıl Doğrulanır
Dağıtımdan önce güncel CometAPI model dizini veya Models API üzerinden model kullanılabilirliğini doğrulayabilirsiniz. Tam model kimliğinin hesabınızda göründüğünü teyit edin, ardından bunu üretim bir Dify iş akışına eklemeden önce küçük, kimliği doğrulanmış bir istek çalıştırın.
Kendi anahtarınızla başarılı bir akışsız çağrı, bir Chat Completions nesnesi döndürür. Üretilen metin değişkenlik gösterecektir, ancak yanıt aşağıdaki alanları içermelidir:
{ "id": "chatcmpl-...", "object": "chat.completion", "model": "the-routed-model-id", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "..." }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 0, "completion_tokens": 0, "total_tokens": 0 }}
Dify'da eşdeğer başarı sinyali, çıktı panelinde metin bulunan tamamlanmış bir LLM düğümüdür. Seçilen model, geçen süre, token kullanımı ve normalize edilmiş sağlayıcı hatası için Dify'nın çalışma günlüklerini kontrol edin.
Dify İçin Doğru Model Nasıl Seçilir
Sağlayıcı adından ziyade iş yüküyle başlayın. Zor akıl yürütme, büyük kod tabanları veya yüksek değerli yanıtlar için öncü bir modeli; etkileşimli sohbet ve tekrarlanan iş akışı adımları için daha hızlı bir modeli; sınıflandırma, çıkarım veya diğer sınırlı görevler için daha düşük maliyetli bir metin modelini seçin. Aynı istem setiyle modelleri karşılaştırın ve yanıt kalitesi, gecikme, token kullanımı, araç davranışı ve başarılı çalıştırma başına maliyeti kaydedin. Ayrıca seçilen rotanın gerekli tüm girdi ve özellikleri desteklediğini doğrulayın. Paylaşılan bir CometAPI bağlantısı geçişi basitleştirir; ancak bağlam sınırlarını, multimodal girdileri, araçları, yapılandırılmış çıktıyı veya akıl yürütme kontrollerini modeller arasında aynı yapmaz.
Yaygın Sorun Giderme Senaryoları ve Çözümleri
Dify kimlik bilgisini 401 ile reddediyor. Anahtarı CometAPI panosundan yeniden kopyalayın ve başta veya sonda boşluk olmadığından emin olun. Dify'nın API Key alanına Bearer kelimesini eklemeyin; eklenti yetkilendirme başlığını oluşturur.
Genel sağlayıcı 404 veya HTML döndürüyor. Tam temel URL'yi https://api.cometapi.com/v1. kullanın. Dify'nın temel URL'sinden /v1'i çıkarmak veya /chat/completions eklemek, yanlış bir son yol üretebilir.
Model Dify'da görünmüyor. CometAPI eklentisini güncelleyin, ardından kimliği canlı katalogla karşılaştırın. Güncel kimlik önceden tanımlı değilse, aynı CometAPI sağlayıcısı altında özel bir model olarak ekleyin. Benzer görünen bir model adını ikame etmeyin.
Bir metin isteği çalışıyor ancak görüntüler veya araçlar başarısız oluyor. OpenAI uyumluluğu, istek yüzeyini tanımlar; aynı model davranışı anlamına gelmez. Modelin listelenen modalitelerini ve eklentinin görsel, araç çağırma, yapılandırılmış çıktı ve akıl yürütme ayarlarını yeniden kontrol edin.
İstek bağlam penceresini aşıyor. Dify'da özel modelin bağlam boyutunu doğrulayın, getirilen belgeleri ve konuşma geçmişini kısaltın ve çıktı için yer ayırın. Daha büyük katalog bağlamı, Dify iş akışı sınırlarını veya sağlayıcıya özgü token kurallarını ortadan kaldırmaz.
429 veya aralıklı 5xx hataları alıyorsunuz. 429, zaman aşımı ve geçici sunucu hatalarını üstel geri çekilme ve jitter ile yeniden deneyin. Kimlik doğrulama, geçersiz model veya hatalı biçimlendirilmiş istek hatalarını otomatik olarak yeniden denemeyin.
Üretim Notları
Gizlileri sunucu tarafında saklayın. Geliştirme ve üretim için ayrı CometAPI anahtarları kullanın, mantıklı kotalar belirleyin, ifşa edilen anahtarları döndürün ve gerçek kimlik bilgilerini Dify uygulamalarıyla dışa aktarmaktan kaçının.
Test edilmiş bir model kimliğini sabitleyin. Katalogda daha yeni bir ad göründüğü için bir modeli sessizce değiştirmeyin. Sağlayıcı aynı olsa bile yetenek, gecikme, çıktı stili ve fiyat sürümler arasında değişebilir.
Rotaya göre ölçüm yapın. Her üretim çağrısı için model kimliğini, gecikmeyi, token kullanımını, hata kodunu ve Dify uygulama sürümünü kaydedin. Bu, modellere kıyaslama yapmayı ve maliyet değişikliklerini izlenimlere güvenmeden araştırmayı mümkün kılar.
Yeteneklere göre yedek tasarlayın. Rutin trafik için daha düşük maliyetli bir model ve yükseltme için daha güçlü bir model kullanın; ancak yalnızca aynı girdileri ve gerekli araçları destekleyen modelleri eşleştirin. Modelleri değiştirmeden önce geçici hataları yeniden deneyin, toplam gecikme bütçesini sınırlayın ve her yedek rotayı test edin. Üretim desenine ilişkin CometAPI'nin model fallback kılavuzuna bakın.
Yayın öncesinde fiyatları yeniden kontrol edin. Bu yazıdaki ücretler tarihli bir anlık görüntüdür, sözleşme değildir. Bir bütçe belirlemeden veya maliyet beyanı yayınlamadan önce fiyatlandırma kılavuzunu ve canlı model dizinini gözden geçirin.
SSS
CometAPI üzerinden OpenAI'yi Dify'a nasıl eklersiniz?
CometAPI model sağlayıcı eklentisini kurun, CometAPI anahtarınızı kaydedin ve gpt-5.6 modelini seçilebilir bir LLM modeli olarak ekleyin. Dify tamamlama modu istediğinde Chat modunu seçin, ardından modeli üretim iş akışında etkinleştirmeden önce kısa bir metin istemi çalıştırın. Güncel CometAPI kataloğu, uyumlu chat ve Responses iş yükleri için rotayı listeler; ancak Dify eklenti desteği sürüme göre değişebilir. Kimlik önceden tanımlı değilse eklentiyi güncelleyin veya özel model seçeneğini kullanın. Paylaşılan sağlayıcı kimlik bilgisini değiştirmeden bırakın ve görüntü girişi, araç çağırma, yapılandırılmış çıktı ve akıl yürütme ayarlarını güvenmeden önce ayrı ayrı doğrulayın.
CometAPI üzerinden Claude'u Dify'a nasıl eklersiniz?
Aynı CometAPI sağlayıcı bağlantısı altında claude-opus-5 modelini ayrı bir LLM modeli olarak ekleyin ve Claude'a ihtiyaç duyan Dify düğümünde bunu seçin. CometAPI kataloğu şu anda bu model için hem Anthropic Messages hem de OpenAI uyumlu sohbet rotalarını belgeliyor. OpenAI rotasından farklı olarak Claude kimliği, desteklenen girdiler, token sınırları ve davranışlar farklı olduğundan Dify'nın kendi model girişine ihtiyacı vardır. Basit bir yanıtı ve temsili uzun veya araç destekli bir görevi test edin, ardından varsayılan yapmadan önce gerçek model, gecikme, token kullanımı ve normalize edilmiş hatalar için Dify çalışma günlüğünü inceleyin.
CometAPI üzerinden Gemini'yi Dify'a nasıl eklersiniz?
Mevcut CometAPI sağlayıcısı altında gemini-3.7-flash modelini ekleyin, ardından ilgili Dify LLM düğümünde bu girişi seçin. CometAPI şu anda hem yerel Gemini generating-content rotasını hem de OpenAI uyumlu sohbet rotasını listeler. Temel bir Dify sohbet iş akışı için metinle başlayın ve görüntüler, PDF'ler, ses veya video girdileri test edilmeden önce başarılı bir çalıştırmayı doğrulayın. Bu modaliteler, model kataloğunda listelense bile eklenti sürümüne ve düğüm yapılandırmasına bağlı olabilir. Gemini'yi ayrı bir model yapılandırması olarak tutun ki uygun sınırlar ayarlayabilesiniz ve hız, kalite ve maliyetini diğer rotalarla karşılaştırabilesiniz.
CometAPI üzerinden DeepSeek'i Dify'a nasıl eklersiniz?
Aynı CometAPI sağlayıcı kimliğini yeniden kullanırken deepseek-v4-flash için ayrı bir Dify model girişi oluşturun. Güncel CometAPI kataloğu bu rotayı metinden metne sohbet iş yükleri için listeler; bu nedenle OpenAI, Claude veya Gemini yapılandırmalarındaki görüntü ayarlarını kopyalamayın. Önce kısa bir metin istemi test edin, ardından gerçekten çalıştırmayı planladığınız kodlama veya akıl yürütme görevini deneyin. Model Dify'da yoksa eklentiyi güncelleyin veya özel model seçeneğiyle güncel kimliği ekleyin. Üretim trafiğini yönlendirmeden önce canlı model sayfasından dinamik fiyatlandırmayı ve kullanılabilirliği yeniden kontrol edin.
OpenAI, Claude, Gemini ve DeepSeek'i aynı Dify iş akışında kullanabilir miyim?
Evet. Her LLM düğümü farklı bir model sağlayıcısı/model yapılandırması kullanabilir. CometAPI ile desteklenen modeller aynı sağlayıcı kimlik bilgisini paylaşabilirken iş akışı farklı model kimliklerini seçebilir.
Tek bir CometAPI anahtarı Dify'da gerçekten OpenAI, Claude, Gemini ve DeepSeek'i kapsar mı?
Evet. Dify CometAPI model eklentisi tek bir sağlayıcı kimlik bilgisini saklar ve bu kimliği bu aileler arasındaki desteklenen modeller için kullanır. Yine de Dify'nın hangi modeli çağıracağını bilmesi için her model kimliğini seçer veya eklersiniz.
Dify'da CometAPI temel URL'sini girmem gerekir mi?
Özel CometAPI eklentisini kullandığınızda gerekmez; https://api.cometapi.com/v1 dahili olarak ayarlanır. Bu temel URL'yi yalnızca Dify'nın OpenAI API ile uyumlu genel model sağlayıcısını kullandığınızda manuel olarak girin.
Dify, OpenAI ile uyumlu bir API üzerinden Claude'u destekliyor mu?
Dify, OpenAI ile uyumlu model sağlayıcılarıyla çalışabilir; ancak uyumluluk, Claude'un API davranışını OpenAI ile aynı yapmaz. Araçlar, yapılandırılmış çıktı, görsel veya akıl yürütme odaklı özellikleri etkinleştirmeden önce modelin desteklediği parametreleri ve yetenekleri doğrulayın.
Her model için aynı Dify ayarlarını kullanabilir miyim?
Hayır. Uç nokta ve anahtar paylaşılabilir; ancak bağlam sınırları, modaliteler, araç desteği, akıl yürütme kontrolleri, gecikme ve fiyatlar model özelinde kalır. Her model eşlemesini test edilmiş bir yapılandırma olarak ele alın.
Hangi modeli varsayılan yapmalıyım?
Kendi istemlerinizi test ettikten sonra seçin. Düşük maliyetli bir model rutin sınıflandırma veya yeniden yazma işlerini üstlenebilirken daha güçlü bir model karmaşık akıl yürütme veya daha yüksek değerli yanıtlar için uygundur. İş yükü verisi olmadan evrensel bir “en iyi” iddiasından kaçının.
Sonuç
CometAPI, uyumlu sohbet iş yükleri için tek bir sağlayıcı kimliği ve tek bir birleşik API uç noktasıyla bir Dify çalışma alanının OpenAI, Claude, Gemini ve DeepSeek'i kullanmasına olanak tanır. Kurulum kısadır: model eklentisini kurun, anahtarı kaydedin, güncel model kimliklerini eşleyin ve her rotayı test edin. Operasyonel çalışma ise model özelindedir—yetenekler, bağlam, fiyatlandırma ve yedek davranışı varsayılmamalı, doğrulanmalıdır.