LibreChat - 可自托管多模型对话平台 - apps / librechat | 88API AI API 接入、配置与使用文档

配置方式与普通客户端不同

LibreChat 的自定义服务商主要通过项目根目录的 .env 和 librechat.yaml 配置。 Docker 部署还必须将 YAML 文件挂载到 API 容器。

LibreChat 是可自托管的开源多模型对话平台，支持通过自定义 endpoint 连接 OpenAI 兼容服务。

官网：https://www.librechat.ai
官方文档：https://www.librechat.ai/docs
GitHub：https://github.com/danny-avila/LibreChat

使用前准备

已安装并能够启动 LibreChat。
在 88API 创建 API Key。
从 88API 模型列表复制至少一个准确模型 ID。
能够编辑 LibreChat 项目根目录中的 .env、librechat.yaml；Docker 用户还需要编辑 docker-compose.override.yml。

文件作用

文件	作用
`.env`	保存 API Key 等敏感变量
`librechat.yaml`	定义 88API endpoint、Base URL 和模型
`docker-compose.override.yml`	Docker 部署时将 YAML 挂载到容器

第一步：保存 API Key

在项目根目录的 .env 中加入：

EIGHTYEIGHT_API_KEY=<你的 88API API Key>

变量名不能以数字开头，因此这里使用 EIGHTYEIGHT_API_KEY。不要把真实密钥直接写入 librechat.yaml，也不要把 .env 提交到公开仓库。

第二步：配置 librechat.yaml

在项目根目录创建或编辑 librechat.yaml：

version: 1.3.13
cache: true

endpoints:
  custom:
    - name: "88API"
      apiKey: "${EIGHTYEIGHT_API_KEY}"
      baseURL: "https://88api.ai/v1"
      models:
        default:
          - "<从 88API 模型列表复制的准确模型 ID>"
        fetch: true
      titleConvo: true
      titleModel: "current_model"
      modelDisplayLabel: "88API"

关键字段：

字段	说明
`name`	endpoint 唯一名称，将显示在选择器中
`apiKey`	引用 `.env` 中的变量
`baseURL`	`https://88api.ai/v1`
`models.default`	至少填写一个准确模型 ID
`models.fetch`	是否尝试从服务端获取模型列表
`modelDisplayLabel`	消息旁显示的服务商名称

不要添加 provider: anthropic

即使你通过 88API 使用 Claude 模型，这里仍是 OpenAI 兼容接口，应省略 provider。 provider: anthropic 只用于原生 Anthropic Messages API，会改变请求协议。

第三步：Docker 挂载配置

非 Docker 本地安装可以跳过本节。Docker 用户先复制官方示例：

cp docker-compose.override.yml.example docker-compose.override.yml

确认 docker-compose.override.yml 的 api 服务包含：

services:
  api:
    volumes:
      - type: bind
        source: ./librechat.yaml
        target: /app/librechat.yaml

如果 override 文件已有其他服务或挂载项，请合并这段配置，不要覆盖原内容。

第四步：重启并验证

Docker 部署：

docker compose down && docker compose up -d

非 Docker 本地运行：停止当前后端进程，再执行：

npm run backend

打开 LibreChat，在 endpoint 选择器中找到 88API，选择模型并发送测试消息。随后在 88API 控制台使用日志中确认出现请求。

下图以 LibreChat 官方文档中的 endpoint 选择器为底图，仅将一个自定义 endpoint 名称替换为 88API，用于说明 YAML 配置生效后的验证位置；真正的配置入口仍是上面的 .env、librechat.yaml 和 Docker 挂载，而不是这个菜单。

LibreChat 重启后在 endpoint 选择器中出现 88API

每位用户填写自己的 Key

多用户部署不希望管理员统一保存 Key 时，可以将：

apiKey: "${EIGHTYEIGHT_API_KEY}"

改为：

apiKey: "user_provided"

用户随后在 LibreChat 的 Settings → Data controls → API keys 中保存自己的密钥。

常见问题

88API 没有出现在 endpoint 选择器

依次检查：

librechat.yaml 的 YAML 缩进是否正确；
.env 是否存在对应变量；
Docker 是否已挂载 /app/librechat.yaml；
修改后是否重启 LibreChat。

Docker 用户可查看：

docker compose logs api

获取模型列表很慢或失败

将 models.fetch 改为 false，并在 models.default 中显式列出需要的模型。官方说明 fetch 默认就是 false，开启后可能增加首次加载时间。

Base URL 应该写完整 completions 地址吗

不需要。填写 https://88api.ai/v1，LibreChat 会自动追加 /chat/completions。只有服务商要求直接调用完整端点时才使用 directEndpoint: true，88API 常规配置不需要。

YAML 校验失败

不要绕过配置校验。检查引号、空格和数组缩进，确保 endpoint 名称唯一，并确认当前 LibreChat 版本支持配置中的字段。