开发者资源

LibreChat

为 RunAPI 配置 LibreChat custom endpoint，在 Docker 中挂载 YAML，重启并验证聊天。

查看 Markdown

LibreChat custom endpoint 属于部署配置，不是普通用户的 Connection 表单。你需要能够修改 LibreChat 部署文件，并从身份验证指南创建标准 RunAPI API Key。

安装 LibreChat

按照 LibreChat 官方本地安装指南完成安装，或使用现有部署。先确保 LibreChat 正常运行，再添加 custom endpoint。

添加 RunAPI endpoint

在 LibreChat 部署目录创建或更新 librechat.yaml。请将 YOUR_RUNAPI_MODEL_ID 替换为模型目录中的当前 identifier。

YAML

version: 1.3.13
endpoints:
  custom:
    - name: "RunAPI"
      apiKey: "${RUNAPI_API_KEY}"
      baseURL: "https://runapi.ai/v1"
      models:
        default: ["YOUR_RUNAPI_MODEL_ID"]
        fetch: true
      titleConvo: true
      titleModel: "current_model"
      modelDisplayLabel: "RunAPI"

将 Key 存在 .env 中，不要直接写入 YAML：

SHELL

RUNAPI_API_KEY=YOUR_RUNAPI_API_TOKEN

使用 Docker Compose 时，确认 docker-compose.override.yml 已挂载配置文件：

YAML

services:
  api:
    volumes:
      - ./librechat.yaml:/app/librechat.yaml

修改任一文件后都要重启 LibreChat deployment。

选择模型

models.default 确保至少有一个已知 model。启用 models.fetch: true 后，LibreChat 还会请求当前 model inventory。即使启用了自动发现，也应保留一个有效的默认 identifier，避免发现暂时不可用时整个 endpoint 无法使用。

验证连接

重启后，在 endpoint selector 中选择 RunAPI，选择已配置 model，然后发送 只回复 connected。。收到正常回复即表示部署配置和 model request 都已生效。

排查问题

endpoint selector 中没有 RunAPI： 检查 YAML 缩进，确认 docker-compose.override.yml 已挂载文件，然后重启 API container。
endpoint 出现但身份验证失败： 确认 .env 为 API container 定义了 RUNAPI_API_KEY；若 container 环境仍是旧值，请重新创建 container。
没有自动发现的 models： 在 models.default 中保留一个当前 identifier，确认 baseURL 以 /v1 结尾，并检查 API container logs。
LibreChat 忽略修改后的 YAML： 核对 volume mount 的 host path 与 container path 是否指向刚编辑的文件。

通用协议行为请查看 LLM API 快速开始。请求和响应字段请查看 Chat Completions API 参考。