将 LibreChat 接入 XiuRouter | XiuAI 文档中心

在 librechat.yaml 中添加 XiuRouter 自定义端点，并通过环境变量提供 API Key。

LibreChat 可以把 XiuRouter 配成 OpenAI-compatible custom endpoint。Base URL 使用 https://router-api.xiu.ai/v1，API Key 从运行环境读取。

前置条件

可以修改 LibreChat 的 librechat.yaml 和运行环境。
已创建一把 LibreChat 专用 XiuRouter API Key。
已从 XiuRouter 当前目录复制模型 ID。

设置 API Key

在 LibreChat 服务实际读取的环境中设置：

XIUROUTER_API_KEY=YOUR_XIUROUTER_API_KEY

不要把真实值提交到仓库。容器部署应使用平台 Secret 或受控环境文件。

添加自定义端点

把下面内容合并到 librechat.yaml：

version: 1.3.1

endpoints:
  custom:
    - name: XiuRouter
      apiKey: "${XIUROUTER_API_KEY}"
      baseURL: "https://router-api.xiu.ai/v1"
      models:
        default:
          - "YOUR_MODEL_ID"
        fetch: true
      titleConvo: true
      titleModel: "YOUR_MODEL_ID"
      modelDisplayLabel: XiuRouter

fetch: true 会尝试读取 /v1/models。保留一个 default 模型，避免模型发现暂时失败时端点完全不可选。titleModel 也必须是这把 Key 可调用的模型。

验证

重启 LibreChat，使配置和环境变量生效。
选择 XiuRouter endpoint 和目标模型。
发起一个短文本请求。
在 XiuRouter“使用记录”核对模型、服务分组、状态和费用。

LibreChat 的文件、代码执行、搜索和代理能力有自己的配置。自定义端点只负责模型请求，不代表这些能力自动可用。

常见失败

现象	处理
XiuRouter 没出现在端点列表	检查 YAML 层级和 LibreChat 实际读取的配置文件
模型发现返回 `401`	确认服务进程能读取 `XIUROUTER_API_KEY`
标题生成失败	把 `titleModel` 改为已验证模型，或关闭 `titleConvo`
普通聊天成功但代理工具失败	单独检查模型工具能力和 LibreChat Agent 配置

回滚

从 endpoints.custom 删除 XiuRouter 项，重启 LibreChat 并确认恢复原端点。随后撤销 LibreChat 专用 XiuRouter API Key。

来源与核对日期

本文按 LibreChat 当前 custom endpoint 配置和 XiuRouter 模型列表、Chat Completions 路由核对，日期为 2026-08-19。本轮未运行真实 LibreChat 计费任务。