跳到主要内容
Router One

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

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
# 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 状态和限额。