一条 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 — 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-keyLibreChat 该填哪个模型 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 状态和限额。