> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Dify

> OpenAI sağlayıcısını ve özel bir base URL kullanarak TokenLab'i Dify ile entegre edin

## 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

<Note>
  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.
</Note>

<Note>
  **Tür**: Çerçeve veya Platform

  **Birincil Yol**: OpenAI uyumlu sohbet yolu

  **Destek Güveni**: Kapsam sınırlamalarıyla desteklenir
</Note>

## Ö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](https://tokenlab.sh/dashboard) adresine giriş yapın
2. [API Keys](https://tokenlab.sh/dashboard/api) 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

<Steps>
  <Step title="Model Sağlayıcılarını Açın">
    Dify içinde **Settings** → **Model Providers** kısmına gidin
  </Step>

  <Step title="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.
  </Step>

  <Step title="TokenLab Ayarlarını Girin">
    Şu değerleri kullanın:

    | Alan                           | Değer                        |
    | ------------------------------ | ---------------------------- |
    | API Key                        | `sk-your-tokenlab-key`       |
    | API Base URL / Custom Base URL | `https://api.tokenlab.sh/v1` |
  </Step>

  <Step title="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`
  </Step>
</Steps>

### 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 sohbet | `gpt-5.4-mini`, `gpt-5.4`, `claude-sonnet-5`               |
| Derin muhakeme    | `gpt-5.5`, `gpt-5.4`, `claude-opus-4-8`, `deepseek-v4-pro` |
| Hızlı/ucuz        | `gpt-5.4-mini`, `gemini-3.5-flash`, `deepseek-v4-flash`    |
| Embedding'ler     | `text-embedding-3-small`, `text-embedding-3-large`         |

## En İyi Uygulamalar

<AccordionGroup>
  <Accordion title="Yerleşik OpenAI sağlayıcısı ile başlayın">
    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.
  </Accordion>

  <Accordion title="İterasyon için daha ucuz modeller kullanın">
    İ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.
  </Accordion>

  <Accordion title="Dify'ın genellikle sohbet tamamlama odaklı olduğunu unutmayın">
    Ç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.
  </Accordion>
</AccordionGroup>

## Sorun Giderme

<AccordionGroup>
  <Accordion title="Bağlantı Hatası">
    * 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
  </Accordion>

  <Accordion title="401 Unauthorized">
    * 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
  </Accordion>

  <Accordion title="Model Bulunamadı">
    * 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
  </Accordion>
</AccordionGroup>