将 LibreChat 接入 XiuRouter

首次配置需要保存服务端 Secret，并添加 XiuRouter OpenAI-compatible custom endpoint。已有配置时保留原 endpoint，只追加 XiuRouter。models.default 是必填回退值，fetch 会从 /v1/models 自动扩充列表。

选择配置方式

• 首次配置：保存 Secret，再添加 XiuRouter custom endpoint。
• 替换已有：保留原 endpoint，只追加 XiuRouter。
• 对话协助：不提供。LibreChat 配置和 Secret 由服务端部署环境管理。

前置条件

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

保存服务端 Secret

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

XIUROUTER_API_KEY=YOUR_XIUROUTER_API_KEY

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

添加自定义端点

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

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: "current_model"
      modelDisplayLabel: XiuRouter

只追加这个 endpoints.custom 项，不覆盖原 endpoint。fetch: true 会读取 /v1/models。default 在发现失败时回退，titleModel: current_model 不要求再维护第二个模型 ID。

验证

1. 重启 LibreChat，使配置和环境变量生效。
2. 选择 XiuRouter endpoint 和目标模型。
3. 发起一个短文本请求。
4. 在 XiuRouter 控制台“检查实际请求”核对模型、接口和成功状态。

自定义端点连接模型请求；文件、代码执行、搜索和代理能力仍按 LibreChat 自己的配置启用。

常见失败

回滚

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

来源与核对日期

内容核对于 2026-08-31。LibreChat 收到完整回复，并在 XiuRouter“检查实际请求”中出现对应模型、接口和成功状态后，基础接入才算完成。