---
title: "将 LibreChat 接入 XiuRouter"
description: "在 librechat.yaml 中添加 XiuRouter 自定义端点，并通过环境变量提供 API Key。"
image: "https://docs.xiu.ai/og.png"
---

> XiuAI 文档索引
> 完整文档索引：https://docs.xiu.ai/llms.txt
> 阅读前先通过索引确认当前可用页面。

# 将 LibreChat 接入 XiuRouter

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 服务实际读取的环境中设置：

```bash
XIUROUTER_API_KEY=YOUR_XIUROUTER_API_KEY
```

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

## 添加自定义端点

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

```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 可调用的模型。

## 验证

1. 重启 LibreChat，使配置和环境变量生效。
2. 选择 XiuRouter endpoint 和目标模型。
3. 发起一个短文本请求。
4. 在 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 计费任务。

源文件：https://docs.xiu.ai/router/integrations/librechat/index.mdx