88API88API
使用指南AI 应用API 文档帮助支持

LibreChat - 可自托管多模型对话平台

通过 librechat.yaml 将 LibreChat 接入 88API。

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

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

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

使用前准备

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

文件作用

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

第一步:保存 API Key

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

EIGHTYEIGHT_API_KEY=<你的 88API API Key>

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

第二步:配置 librechat.yaml

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

version: 1.3.17
cache: true

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

关键字段:

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

不要添加 provider: anthropic

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

如需改用原生 Messages 协议,请另建一个 endpoint:设置 provider: anthropic,baseURL 填写 https://api.88api.ai(不带 /v1,Anthropic SDK 会自动追加 /v1/messages),并将 models.fetch 设为 false、手动列出 Claude 模型。不要在以 /v1 结尾的 baseURL 上添加 provider: anthropic,否则会请求 /v1/v1/messages 并返回 404。

第三步: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,点击左上角的模型选择器,将鼠标移到 88API ① 上,在展开的模型列表中选择要使用的模型 ② (可在顶部搜索框输入模型名),然后发送测试消息。随后在 88API 控制台使用日志中确认出现请求。

LibreChat 模型选择器中的 88API 模型列表

配置入口仍是上面的 .env、librechat.yaml 和 Docker 挂载,这个菜单只用于选择模型。

识图

在模型列表中选择支持图片输入的模型(例如 deepseek-v4.1-flash),在输入框中上传图片并提问即可,无需额外配置。

每位用户填写自己的 Key

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

apiKey: "${EIGHTYEIGHT_API_KEY}"

改为:

apiKey: "user_provided"

用户随后在模型选择器中选中 88API,点击其旁边的齿轮图标,在 Set API Key / 设置 API 密钥 对话框中保存自己的 88API Key;之后也可以在 Settings → Data & Privacy → API keys → Provider API keys 中查看或更换。

常见问题

88API 没有出现在 endpoint 选择器

依次检查:

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

Docker 用户可查看:

docker compose logs api

获取模型列表很慢或失败

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

Base URL 应该写完整 completions 地址吗

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

YAML 校验失败

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

官方依据