# 一条 LibreChat 自定义端点，背靠整个模型目录

> https://router.one/zh/integrations/librechat 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。
> 最后更新：2026-09-02

LibreChat 是开源、可自托管的 ChatGPT 风格聊天界面，任何 OpenAI 兼容 API 都能在 librechat.yaml 里加为自定义端点。一条指向 Router One 的配置，就能让实例上所有用户在端点菜单里用到 GPT、Claude、Gemini、DeepSeek 系列——网关在大陆可直连，部署在国内服务器上也不用代理，支付宝或银行卡即可充值；每次对话在网关侧都有成本 Trace，共享部署的账单也能逐条对清。

## 把 LibreChat 配置到 Router One base URL

在 librechat.yaml（挂载到 API 容器的 /app/librechat.yaml）的 endpoints.custom 下新增一条：baseURL 指向网关，apiKey 引用 .env 里的环境变量，models.fetch 设为 true，让模型列表从网关的 /models 端点自动拉取。models.default 是拉取失败时的兜底列表，titleConvo 打开后会用当前模型给新会话起标题：

`librechat.yaml`

```bash
# librechat.yaml — add under your existing endpoints: key
endpoints:
  custom:
    - name: "Router One"
      apiKey: "${ROUTER_ONE_API_KEY}"
      baseURL: "https://api.router.one/v1"
      models:
        default: ["<model-id-from-/models>"]
        fetch: true
      titleConvo: true
      titleModel: "current_model"
      modelDisplayLabel: "Router One"

# .env
ROUTER_ONE_API_KEY=sk-your-router-one-key
```

## LibreChat 该填哪个模型 ID？

从 /models 页复制精确的模型 ID——ID 区分大小写，页面同时列出每个模型的上下文窗口、能力和当前单价。建议为每个工具单独建一个 API Key，并设置 maxSpend 消费上限，这样单个工具跑飞不会影响其他工作负载。

## 在 trace 里验证 LibreChat 的调用

发出第一个请求后，到 Dashboard → Logs 查看它的完整 trace：模型、tokens、花费、延迟和状态码。LibreChat 的每一次调用从此都有账本和轨迹，不再是黑盒。

## 常见问题

### models.fetch 和固定模型列表怎么选？

想让目录里的模型一上线就出现，用 fetch: true——LibreChat 会请求网关的 /models 端点，default 数组只在请求失败时兜底。想控制用户能看到什么，就用 fetch: false 加一份明确的 default 列表，比如只放三个模型，ID 从 /models 页精确复制；用户只能在你列出的模型里选。

### 能让用户自带 Router One Key 吗？

能——把 apiKey 改成 user_provided，LibreChat 会在界面里向每位用户索取 Key。每个人的花费都落在自己的 Key 和 Trace 上，共享实例分账最省事，也不会动到你自己的钱包。

### LibreChat 能通过网关用哪些模型？

目录里任何具备对话能力的模型——GPT、Claude、Gemini、Grok、DeepSeek、GLM、MiniMax、豆包等系列。/models 页是模型 ID 与单价的事实来源。

### 中国大陆能直连吗？

能。网关在大陆可直连、无需 VPN，配置与全球环境完全一致。

### 报 401/403/429 怎么排查？

先到 Dashboard → Logs 看请求有没有到达网关以及状态码，再对照错误码速查页逐项检查环境变量、Key 状态和限额。

## 相关页面

- 全部接入指南：https://router.one/zh/integrations
- LibreChat 的 401/403/429 排查：https://router.one/zh/llm-api-error-codes
- n8n 接入：https://router.one/zh/integrations/n8n
- Immersive Translate 接入：https://router.one/zh/integrations/immersive-translate
- Open WebUI 接入：https://router.one/zh/integrations/open-webui
- Chatbox / Cherry Studio 接入：https://router.one/zh/chatbox-cherry-studio
- 网关层负责什么：https://router.one/zh/llm-api-gateway
- OpenAI 兼容 API：https://router.one/zh/openai-compatible-api
- API 文档：https://router.one/zh/docs
- 本页规范地址：https://router.one/zh/integrations/librechat
- 模型与每模型 token 价格：https://router.one/zh/models （markdown：https://router.one/zh/models.md ）
- 定价：https://router.one/zh/pricing
- API 文档（markdown）：https://router.one/zh/docs.md
- 公司事实（markdown）：https://router.one/zh/facts/company.md