Hubungkan LibreChat ke CheapTokens: custom endpoint librechat.yaml

LibreChat Anda sudah berjalan, tetapi menu model hanya menampilkan model bawaan. Untuk menambahkan CheapTokens, Anda menulis satu entri endpoints.custom di librechat.yaml: sebuah nama, base URL https://api.cheaptokens.dev/v1, key sebagai environment variable, dan daftar id model. Restart container, dan endpoint "CheapTokens" muncul di menu.

Nama field di bawah ini berasal dari referensi custom endpoint LibreChat (dokumen cabang "Latest (dev)", dicek 30 Oktober 2026). Halaman tersebut tidak mencantumkan nomor versi, jadi jika instalasi Anda lebih lama dan suatu field berperilaku berbeda, bandingkan dengan dokumen untuk rilis Anda. Sisi API-nya adalah yang dari dokumen kami: format OpenAI Chat Completions, satu saldo untuk semua model.

Yang dibutuhkan entri#

Empat field wajib diisi, dan masing-masing punya tugas yang jelas:

• name — nama endpoint di menu.
• apiKey — key. Dokumen menyarankan referensi seperti ${VAR} alih-alih key itu sendiri, agar rahasia tidak masuk ke YAML.
• baseURL — tujuan request: https://api.cheaptokens.dev/v1.
• models.default — daftar id model yang ditampilkan di menu.

Dua field opsional layak diatur. titleConvo: true memungkinkan LibreChat memberi nama chat Anda (judul dibuat kecuali nilainya false), dan modelDisplayLabel adalah label di samping jawaban (default-nya "AI"). models.fetch secara default bernilai false, jadi LibreChat tidak akan meminta daftar model ke API; menu berasal dari models.default. Itulah sebabnya id di bawah ditulis lengkap.

Hubungkan dalam tiga langkah#

services:
  api:
    environment:
      CHEAPTOKENS_API_KEY: ct_your_key_here

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'

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

docker compose up -d

Buka LibreChat di browser, mulai chat baru dan pilih CheapTokens di menu endpoint. Ketiga model ada di daftar. Kirim "Say hi in one sentence" dan Anda seharusnya mendapat jawaban. Jika tidak, lompat ke bagian terakhir.

Tiga model dalam satu menu#

Inilah bagian yang membuat chat self-hosted layak dimiliki. Misalnya Anda menjalankannya untuk tim kecil. Sebagian besar pertanyaan bersifat sehari-hari: tulis ulang email ini, jelaskan error ini. Untuk itu, zai-org/GLM-5.3-Flash sudah cukup, dengan context window 390K dan hingga 8.192 token per jawaban. Saat seseorang menempelkan dokumen panjang dan ingin jawaban panjang, mereka beralih di chat yang sama ke deepseek-ai/DeepSeek-V4-Flash-0731 (konteks 380K, hingga 32.768 token per jawaban). MiniMaxAI/MiniMax-M2.7 (konteks 180K) adalah pendapat ketiga saat dua jawaban berbeda. Tanpa langganan kedua, tanpa key kedua: ketiganya ditagih dari satu saldo.

Berapa biaya chat itu? Ambil tim berisi lima orang yang mengirim 200 pesan sehari, masing-masing membawa sekitar 3.000 token input (riwayat terus bertambah) dan mendapat sekitar 500 token kembali:

Dalam tabel, harga tiap model untuk 200 request tersebut dihitung dengan input dan output digabung, dan totalnya lebih murah daripada OpenRouter. Pilih baris yang sesuai dengan penggunaan Anda dan bandingkan dengan halaman harga.

Jika endpoint tidak muncul atau menjawab dengan error#

Sebagian besar masalah adalah salah satu dari tiga hal. Pilih yang sesuai dengan yang Anda lihat:

Setelah pesan pertama berhasil, Anda bisa menambahkan id lain ke models.default kapan pun Anda ingin model lain di menu. Lebih suka front end lain? Ide yang sama, base URL plus key, ada di Hubungkan Open WebUI ke CheapTokens, dan gambaran umumnya ada di API kompatibel OpenAI: apa itu base_url. Model-modelnya sendiri ada di halaman GLM.