Ana içeriğe atla

​
Genel Bakış

Dify, OpenAI uyumlu model sağlayıcı akışı aracılığıyla TokenLab ile uyumlu bir şekilde çalışır. Bu, sohbet tamamlama (chat-completions) odaklı bir entegrasyon yoludur. Dify’ın özel Codex entegrasyonlarıyla aynı yanıtları veya WebSocket davranışlarını sunduğunun bir garantisi olarak okunmamalıdır. Mevcut Dify sürümleri için en güvenli yol genellikle şudur:
  • Yerleşik OpenAI sağlayıcısını seçin
  • TokenLab API anahtarınızı ayarlayın
  • https://api.tokenlab.sh/v1 şeklinde özel bir base URL belirleyin
Bazı eski Dify sürümleri bunu, özel base URL alanı olan yerleşik OpenAI sağlayıcısı yerine OpenAI-API-compatible olarak sunar. Dify arayüzünüz farklı görünüyorsa, o sürümde mevcut olan en yakın OpenAI uyumlu özel sağlayıcı akışını kullanın.
Tür: Çerçeve veya PlatformBirincil Yol: OpenAI uyumlu sohbet yoluDestek Güveni: Kapsam sınırlamalarıyla desteklenir

​
Ön Koşullar

  • API erişimi olan bir TokenLab hesabı
  • Dify Cloud veya kendi sunucunuzda barındırılan (self-hosted) Dify

​
Yapılandırma Adımları

​
Adım 1: API Anahtarınızı Alın

  1. TokenLab Dashboard adresine giriş yapın
  2. API Keys sayfasını açın
  3. sk- ile başlayan bir API anahtarı oluşturun veya kopyalayın

​
Adım 2: Sağlayıcıyı Yapılandırın

1

Model Sağlayıcılarını Açın

Dify içinde Settings → Model Providers kısmına gidin
2

OpenAI'ı Seçin

OpenAI sağlayıcı ayarlarını açın. Dify sürümünüz burada özel bir base URL sunmuyorsa, bunun yerine o sürümde sunulan OpenAI uyumlu özel sağlayıcı seçeneğini kullanın.
3

TokenLab Ayarlarını Girin

Şu değerleri kullanın:
AlanDeğer
API Keysk-your-tokenlab-key
API Base URL / Custom Base URLhttps://api.tokenlab.sh/v1
4

Modelleri Ekleyin

Kullanmak istediğiniz modelleri ekleyin, örneğin:
  • gpt-5.4
  • gpt-5.4-mini
  • claude-sonnet-5
  • claude-opus-4-8
  • gemini-3.5-flash
  • gemini-3.1-flash-lite
  • deepseek-v4-flash

​
Adım 3: Bağlantıyı Test Edin

  1. gpt-5-mini veya gpt-4o gibi bir model seçin
  2. Bir test istemi (prompt) gönderin
  3. Dify’ın geçerli bir yanıt aldığını doğrulayın

​
Bilgi Bankaları için Embedding’ler

RAG ve bilgi bankası indeksleme için şu gibi bir embedding modeli ekleyin:
  • text-embedding-3-small
  • text-embedding-3-large
Ardından, ilgili bilgi bankası veya uygulama ayarlarında bunu varsayılan embedding modeli olarak ayarlayın.

​
Önerilen Model Rolleri

Kullanım DurumuÖnerilen Modeller
Varsayılan sohbetgpt-5.4-mini, gpt-5.4, claude-sonnet-5
Derin muhakemegpt-5.5, gpt-5.4, claude-opus-4-8, deepseek-v4-pro
Hızlı/ucuzgpt-5.4-mini, gemini-3.5-flash, deepseek-v4-flash
Embedding’lertext-embedding-3-small, text-embedding-3-large

​
En İyi Uygulamalar

Daha yeni Dify sürümlerinde, özel base URL’ye sahip yerleşik OpenAI sağlayıcısı genellikle TokenLab için en temiz kurulumdur.
İterasyon yaparken gpt-5.4-mini, gemini-3.5-flash veya deepseek-v4-flash kullanın, ardından daha ağır iş akışlarını yalnızca gerektiğinde daha güçlü modellere geçirin.
Çoğu Dify akışı, OpenAI uyumlu sohbet davranışını kullanır. Codex’e özgü yanıtlar veya WebSocket davranışı gerekiyorsa, Dify yerine özel Codex entegrasyonlarını kullanın.

​
Sorun Giderme

  • Base URL’nin tam olarak https://api.tokenlab.sh/v1 olduğundan emin olun
  • Dify bunları çoğaltıyorsa sondaki eğik çizgileri (trailing slashes) kaldırın
  • Dify sunucusunun genel internet üzerinden TokenLab’e ulaşabildiğini doğrulayın
  • API anahtarını tekrar kontrol edin
  • Anahtarın TokenLab panelinde aktif olduğunu doğrulayın
  • Dify’a yapıştırılan değerin fazladan boşluk veya satır sonu içermediğinden emin olun
  • Model adını tam olarak doğrulayın
  • Sağlayıcı arayüzü eski bir değeri önbelleğe aldıysa model girişini yeniden ekleyin
  • TokenLab dokümanlarında veya panelinde mevcut model durumunu kontrol edin