Bloga dön

Araçlar ve entegrasyonlarKılavuz

LibreChat'i CheapTokens'e bağlayın: librechat.yaml özel uç noktası

Kendi barındırdığınız LibreChat'e bir CheapTokens uç noktası ekleyin: librechat.yaml içinde tek bir girdi, ortam değişkeni olarak anahtar, menüde üç model.

Yazan: CheapTokens TeamYayınlanma tarihi: 4 dk okuma

CheapTokens API'sine işaret eden LibreChat yapılandırma girdisi
Bu sayfada
  1. Girdinin ihtiyaç duyduğu şeyler
  2. Üç adımda bağlayın
  3. Tek menüde üç model
  4. Uç nokta görünmüyorsa veya hata ile yanıtlıyorsa

LibreChat'iniz çalışıyor, ancak model menüsü yalnızca beraberinde gelenleri gösteriyor. CheapTokens eklemek için librechat.yaml dosyasına tek bir endpoints.custom girdisi yazarsınız: bir ad, temel URL https://api.cheaptokens.dev/v1, ortam değişkeni olarak anahtar ve model kimliklerinden oluşan bir liste. Kapsayıcıyı yeniden başlatın, menüde bir "CheapTokens" uç noktası belirir.

Aşağıdaki alan adları LibreChat'in özel uç nokta referansından gelir (dokümanların "Latest (dev)" dalı, 30 Ekim 2026'da kontrol edildi). Sayfada sürüm numarası yok, bu yüzden kurulumunuz daha eskiyse ve bir alan farklı davranıyorsa, sürümünüzün dokümanlarıyla karşılaştırın. API tarafı dokümanlarımızdaki gibidir: OpenAI Chat Completions formatı, her model için tek bakiye.

Girdinin ihtiyaç duyduğu şeyler#

Dört alan zorunludur ve her birinin basit bir görevi vardır:

  • name — uç noktanın menüde nasıl adlandırıldığı.
  • apiKey — anahtar. Dokümanlar, anahtarın kendisi yerine ${VAR} gibi bir referans önerir, böylece gizli bilgi YAML'ın dışında kalır.
  • baseURL — isteklerin gittiği yer: https://api.cheaptokens.dev/v1.
  • models.default — menüde gösterilen model kimliklerinin listesi.

Ayarlanmaya değer iki isteğe bağlı alan var. titleConvo: true, LibreChat'in sohbetlerinizi adlandırmasını sağlar (false olmadıkça başlıklar oluşturulur) ve modelDisplayLabel yanıtların yanındaki etikettir (varsayılan "AI"dır). models.fetch varsayılan olarak false'tür, bu yüzden LibreChat API'den model listesi istemez; menü models.default'ten gelir. Aşağıdaki kimliklerin tam olarak yazılmasının nedeni budur.

Üç adımda bağlayın#

Adım adım

LibreChat'i bağlayın (Docker)

Kapsayıcıya anahtarı verin

Anahtarın LibreChat kapsayıcısına bir ortam değişkeni olarak ulaşması gerekir. LibreChat'in dokümanları, değişkenleri environment altında docker-compose.override.yml içinde ayarlamanıza izin verir, bu yüzden bu dosyayı docker-compose.yml yanında oluşturun. Değişken adı bize ait, herhangi birini seçin, yalnızca YAML'da aynı tutun:

yaml
services:
  api:
    environment:
      CHEAPTOKENS_API_KEY: ct_your_key_here

Değer bir yer tutucudur: CheapTokens kontrol panelinizdeki anahtarı kullanın.

Uç noktayı librechat.yaml dosyasına ekleyin

docker-compose.yml yanında librechat.yaml oluşturun. Yapı, LibreChat'in dokümanlarındaki Mistral örneğini izler, bizim adresimiz ve kimliklerimizle:

yaml
endpoints:
  custom:
    - name: 'CheapTokens'
      apiKey: '${CHEAPTOKENS_API_KEY}'
      baseURL: 'https://api.cheaptokens.dev/v1'
      models:
        default:
          - 'zai-org/GLM-5.3-Flash'
          - 'deepseek-ai/DeepSeek-V4-Flash-0731'
          - 'MiniMaxAI/MiniMax-M2.7'
      titleConvo: true
      modelDisplayLabel: 'CheapTokens'

Dosyayı bağlayın ve yeniden başlatın

Kapsayıcının dosyayı görmesi gerekir. Aynı docker-compose.override.yml dosyasına volumes ekleyin, böylece artık ikisini de içerir:

yaml
services:
  api:
    environment:
      CHEAPTOKENS_API_KEY: ct_your_key_here
    volumes:
      - ./librechat.yaml:/app/librechat.yaml

Ardından uygulayın:

bash
docker compose up -d
Anahtardan menüye: ortam değişkeni, librechat.yaml, bağlama, ardından model listesinde CheapTokens
Anahtardan LibreChat menüsündeki CheapTokens uç noktasına giden yol

LibreChat'i tarayıcıda açın, yeni bir sohbet başlatın ve uç nokta menüsünden CheapTokens seçin. Üç model listede. "Tek cümleyle merhaba de" gönderin ve bir yanıt almalısınız. Alamazsanız, son bölüme geçin.

Tek menüde üç model#

Kendi barındırdığınız bir sohbeti değerli kılan kısım burasıdır. Küçük bir ekip için çalıştırdığınızı varsayalım. Soruların çoğu günlük sorulardır: bu e-postayı yeniden yaz, bu hatayı açıkla. Bunlar için zai-org/GLM-5.3-Flash yeterlidir; 390K bağlam penceresi ve yanıt başına 8.192 token'a kadar. Birisi uzun bir belge yapıştırıp uzun bir yanıt istediğinde, aynı sohbeti deepseek-ai/DeepSeek-V4-Flash-0731'e geçirir (380K bağlam, yanıt başına 32.768 token'a kadar). MiniMaxAI/MiniMax-M2.7 (180K bağlam), iki yanıt çeliştiğinde üçüncü görüştür. İkinci abonelik yok, ikinci anahtar yok: üçü de tek bakiyeden faturalandırılır.

Bu sohbet ne kadar tutar? Günde 200 mesaj gönderen, her biri yaklaşık 3.000 giriş token'ı taşıyan (geçmiş büyür) ve yaklaşık 500 token geri alan beş kişilik bir ekip alın:

Model İstek başına 200 istek OpenRouter, 200 istek
GLM-5.3-Flash $0.00008 $0.016 $0.0284
DeepSeek-V4-Flash $0.000095 $0.019 $0.056
MiniMax-M2.7 $0.00023 $0.045 $0.54

İstek başına 3.000 giriş ve 500 çıkış token'ı. 1M token başına fiyatlar günceldir ve tarifelerimizle birlikte değişir; OpenRouter sütunu aynı iş yükü için referans fiyatları gösterir.

Tabloda, her modelin bu 200 istek için fiyatı giriş ve çıkış birlikte hesaplanır ve toplamda OpenRouter'dan daha ucuza gelir. Kullanımınıza uyan satırı seçin ve fiyatlandırma sayfasıyla karşılaştırın.

Kendin deneDeneyin: bir soruyu iki modele gönderinCevabı göster

Yeni bir sohbet açın, zai-org/GLM-5.3-Flash seçin ve iyi bildiğiniz bir paragrafın özetini isteyin. Aynı menüden modeli deepseek-ai/DeepSeek-V4-Flash-0731 olarak değiştirin ve tekrar sorun. İki yanıtın uzunluğunu ve tonunu karşılaştırın — varsayılan modeli buna göre belirlersiniz.

Uç nokta görünmüyorsa veya hata ile yanıtlıyorsa#

Sorunların çoğu üç şeyden biridir. Gördüğünüzle eşleşeni seçin:

Durumunu seç

Ne görüyorsunuz?

CheapTokens menüde yok

LibreChat dosyanızı hiç okumadı. librechat.yaml dosyasının /app/librechat.yaml konumuna bağlandığından (yukarıdaki geçersiz kılma dosyası), YAML girintisinin bozulmadığından ve değişiklikten sonra docker compose up -d komutunu çalıştırdığınızdan emin olun.

401 Unauthorized

Anahtar eksik veya yanlış. librechat.yaml içindeki ${ sonrasındaki adın tam olarak ortam değişkeninin adı olduğundan ve anahtara boşluk veya tırnak yapıştırılmadığından emin olun. Bu hata hakkında daha fazlası API 401 veya 404 sayfasında.

404 veya model hatası

Model kimliği yanlış. deepseek-ai/DeepSeek-V4-Flash-0731 gibi tam kimliği kullanın; kısa ad kabul edilmez. Tam kimlikleri GET /v1/models ile modelleri listele adımlarıyla listeleyebilirsiniz.

İlk mesaj geçtikten sonra, menüde başka bir model istediğinizde models.default listesine istediğiniz zaman daha fazla kimlik ekleyebilirsiniz. Farklı bir ön yüz mü tercih edersiniz? Aynı fikir, yani bir temel URL artı bir anahtar, Open WebUI'yi CheapTokens'e bağla sayfasında ve genel resim OpenAI uyumlu API: base_url nedir sayfasında. Modellerin kendisi GLM sayfasında.