Kết nối LibreChat với CheapTokens: custom endpoint trong librechat.yaml

LibreChat của bạn đang chạy, nhưng menu model chỉ hiển thị những gì có sẵn. Để thêm CheapTokens, bạn viết một mục endpoints.custom trong librechat.yaml: tên, base URL https://api.cheaptokens.dev/v1, key dưới dạng biến môi trường và danh sách các model id. Khởi động lại container, và một endpoint "CheapTokens" sẽ xuất hiện trong menu.

Tên các trường bên dưới lấy từ tài liệu tham chiếu custom endpoint của LibreChat (nhánh docs "Latest (dev)", kiểm tra ngày 30 tháng 10 năm 2026). Trang này không ghi số phiên bản, nên nếu bản cài của bạn cũ hơn và một trường hoạt động khác đi, hãy đối chiếu với tài liệu cho bản phát hành của bạn. Phía API là API trong tài liệu của chúng tôi: định dạng OpenAI Chat Completions, một số dư cho mọi model.

Mục này cần gì#

Bốn trường là bắt buộc, và mỗi trường có một nhiệm vụ rõ ràng:

• name — tên của endpoint trong menu.
• apiKey — key. Tài liệu khuyến nghị dùng tham chiếu như ${VAR} thay vì chính key, để bí mật không nằm trong YAML.
• baseURL — nơi gửi request: https://api.cheaptokens.dev/v1.
• models.default — danh sách model id hiển thị trong menu.

Có hai trường tùy chọn đáng thiết lập. titleConvo: true cho phép LibreChat đặt tên cho các cuộc trò chuyện của bạn (tiêu đề được tạo trừ khi nó là false), và modelDisplayLabel là nhãn bên cạnh câu trả lời (mặc định là "AI"). models.fetch mặc định là false, nên LibreChat sẽ không hỏi API để lấy danh sách model; menu lấy từ models.default. Đó là lý do các id bên dưới được viết đầy đủ.

Kết nối trong ba bước#

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

Mở LibreChat trong trình duyệt, bắt đầu cuộc trò chuyện mới và chọn CheapTokens trong menu endpoint. Ba model có trong danh sách. Gửi "Say hi in one sentence" và bạn sẽ nhận được câu trả lời. Nếu không, hãy chuyển đến phần cuối.

Ba model trong một menu#

Đây là phần khiến một chat tự host đáng để có. Giả sử bạn chạy nó cho một nhóm nhỏ. Hầu hết câu hỏi là thường ngày: viết lại email này, giải thích lỗi này. Với những việc đó, zai-org/GLM-5.3-Flash là đủ, với cửa sổ ngữ cảnh 390K và tối đa 8.192 token mỗi câu trả lời. Khi ai đó dán một tài liệu dài và muốn câu trả lời dài, họ chuyển cùng cuộc trò chuyện sang deepseek-ai/DeepSeek-V4-Flash-0731 (ngữ cảnh 380K, tối đa 32.768 token mỗi câu trả lời). MiniMaxAI/MiniMax-M2.7 (ngữ cảnh 180K) là ý kiến thứ ba khi hai câu trả lời mâu thuẫn. Không cần gói đăng ký thứ hai, không cần key thứ hai: cả ba đều được tính từ một số dư.

Cuộc trò chuyện đó tốn bao nhiêu? Lấy một nhóm năm người gửi 200 tin nhắn mỗi ngày, mỗi tin mang khoảng 3.000 token đầu vào (lịch sử tăng dần) và nhận về khoảng 500 token:

Trong bảng, giá của mỗi model cho 200 request đó được tính gộp cả đầu vào và đầu ra, và tổng lại rẻ hơn OpenRouter. Chọn hàng khớp với mức sử dụng của bạn và so sánh với trang giá.

Nếu endpoint không hiện ra hoặc trả lời bằng lỗi#

Hầu hết vấn đề là một trong ba trường hợp. Chọn trường hợp khớp với những gì bạn thấy:

Khi tin nhắn đầu tiên đã đi qua, bạn có thể thêm id vào models.default bất cứ khi nào muốn có thêm model trong menu. Thích một front end khác? Cùng ý tưởng, một base URL cộng với một key, có trong Kết nối Open WebUI với CheapTokens, và bức tranh tổng quát nằm trong API tương thích OpenAI: base_url là gì. Bản thân các model nằm trên trang GLM.