LibreChat

LibreChat nhận gateway dưới dạng khối endpoints.custom trong librechat.yaml — bốn trường bắt buộc, key từ .env và cần khởi động lại trước khi bộ chọn hiển thị.

# librechat.yaml — project root, beside your .env
version: 1.3.5          # the value the documentation's own example carries

endpoints:
  custom:
    # Required: name, apiKey, baseURL, models. The name must be unique and
    # must not reuse a built-in endpoint name such as openAI or anthropic.
    - name: "Kunavo"
      apiKey: "${KUNAVO_API_KEY}"        # resolved from .env, not written here
      # Keep the /v1. LibreChat appends /chat/completions to this by default.
      baseURL: "https://api.kunavo.com/v1"
      models:
        default: ["claude-sonnet-5", "claude-haiku-4-5"]
        fetch: true                      # fills the picker from GET /v1/models
      titleConvo: true
      titleModel: "claude-haiku-4-5"         # titles are a separate call — pin a cheap id
      modelDisplayLabel: "Kunavo"

      # Optional but worth the four lines: without it LibreChat prices your
      # traffic from a table it ships. prompt/completion are USD per million
      # tokens; context is that model's own window. All three required.
      tokenConfig:
        claude-sonnet-5:
          prompt: 1.4
          completion: 7
          context: 1000000
        claude-haiku-4-5:
          prompt: 0.7
          completion: 3.5
          context: 200000

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
2. Với Docker, trước tiên hãy mount cấu hình: hướng dẫn khởi động nhanh yêu cầu bạn sao chép docker-compose.override.yml.example vào docker-compose.override.yml và bỏ chú thích cho volume librechat.yaml. Bản cài đặt trực tiếp bỏ qua bước này.
3. Tạo hoặc chỉnh sửa librechat.yaml trong thư mục gốc của dự án — cùng thư mục với .env — rồi thêm mục endpoints.custom ở trên.
4. Đặt khóa trong .env dưới dạng KUNAVO_API_KEY=sk-kn-.... Giá trị giữ chỗ ${KUNAVO_API_KEY} trong YAML sẽ được lấy từ đó, giúp giữ bí mật ngoài tệp cấu hình bạn commit.
5. Khởi động lại LibreChat rồi mở bộ chọn endpoint: Kunavo xuất hiện thành một mục riêng bên cạnh các endpoint tích hợp sẵn; danh sách model được tải từ GET /v1/models hoặc lấy từ mảng models.default của bạn nếu việc tải thất bại.
6. Gửi một tin nhắn, sau đó kiểm tra bộ chọn model có thực sự chuyển model hay không — các mã được phân giải tại endpoint, vì vậy một mã Claude và một mã GPT cùng nằm trong một mục là điều bình thường, không phải cấu hình sai.

Đã kiểm tra đối chiếu với Tài liệu tham chiếu đối tượng endpoint tùy chỉnh của LibreChat vào 21 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

Xác minh trước khi gỡ lỗi ứng dụng khách

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong LibreChat.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.

Ba trường tùy chọn hoạt động khác nhau qua gateway

Mọi thông tin trong bảng này đều lấy từ cùng một tài liệu tham chiếu trường, được đọc vào ngày nêu trên. Đây là mô tả cấu hình của chính LibreChat — không phải kết quả kiểm thử của Kunavo, cũng không phải khẳng định về cách một mã model cụ thể hoạt động sau khi yêu cầu rời khỏi ứng dụng khách.

Hướng dẫn bốn bước — mount, cấu hình, đặt biến môi trường, khởi động lại — có trên trang khởi động nhanh của LibreChat dành cho endpoint tùy chỉnh, trong đó gateway được dùng làm ví dụ thực hành.