客户端接入 · LibreChat

LibreChat 接入 HardysAPI:在 yaml 里加一个 custom 端点

LibreChat 不自带通用兼容配置,需要在 librechat.yaml 里声明一个 custom 端点,然后挂载进容器。

librechat.yaml

librechat.yamlyaml
version: 1.2.1
cache: true
endpoints:
  custom:
    - name: "HardysAPI"
      apiKey: "sk-你的密钥"
      baseURL: "https://hardysapi.com/v1"
      models:
        default:
          - "claude-sonnet-4-5"
          - "gpt-5.5"
        fetch: false
      titleConvo: true
      modelDisplayLabel: "HardysAPI"

挂载与生效

  1. 把文件放到宿主机,例如 /opt/librechat/librechat.yaml;
  2. 在 docker-compose.yml 的 api 服务里加挂载;
  3. 重启容器:docker compose restart api;
  4. 刷新页面,端点下拉里会出现 HardysAPI。
docker-compose 片段yaml
services:
  api:
    volumes:
      - ./librechat.yaml:/app/librechat.yaml
⚠️ fetch: true 会让 LibreChat 启动时去拉 /v1/models,拉取失败可能导致端点不显示。 直接写死模型列表(fetch: false)更稳。

常见坑

  • 端点不显示:yaml 版本号与程序版本不匹配,或缩进错误;先看容器日志里的 yaml 解析报错;
  • 改了 yaml 没生效:文件是挂载的,必须重启 api 容器而不是热重载;
  • 多用户场景:apiKey 写在 yaml 里等于所有人共用一个密钥,需要按用户区分时改用环境变量或反向代理注入。

常见问题

LibreChat 怎么添加第三方中转站?

在 librechat.yaml 的 endpoints.custom 下新增一项,填 baseURL 为 https://hardysapi.com/v1、apiKey 和模型列表。

为什么 LibreChat 里看不到新加的端点?

先检查容器日志中的 yaml 解析错误,再确认配置文件已挂载进容器并重启了 api 服务。