librechat.yaml 里的自定义端点(custom endpoint)加入——配好之后,你列出的 RuAPI 模型都会出现在选择列表里。
前置
1
RuAPI 账号和密钥
控制台 →「令牌管理」→ 创建
sk-... 密钥。你这套 LibreChat 的所有账号都会用这个密钥,所以给它设个预算:关掉「无限额度」,填一个金额。余额用 USDT 充——见充值。2
LibreChat
按 LibreChat 文档安装(一般用 Docker):
git clone https://github.com/LibreChat-AI/LibreChat.git、cd LibreChat、cp .env.example .env。配置
1
在 .env 里加密钥
2
把 librechat.yaml 挂进容器(Docker)
容器自己不会读
librechat.yaml,要挂载进去。先复制示例:cp docker-compose.override.yml.example docker-compose.override.yml,再把里面 services: 这一行和配置文件那一段取消注释:3
在 librechat.yaml 里添加 RuAPI
在
.env 旁边新建 librechat.yaml:4
重启 LibreChat
docker compose down && docker compose up -d。打开 http://localhost:3080,模型选择菜单里会出现 RuAPI 供应商,模型就是 default 里列的那些。把手动列表换成
fetch: true,会通过 /v1/models 拉下 RuAPI 整个目录,画图、视频模型也在里面,所以一般还是在 default 里列出要用的 ID 更清爽。LibreChat 每开一个新对话都会单独发一次请求起标题;没设 titleModel 就用对话本身的模型,所以标题最好交给 deepseek-flash。带提示词缓存的 Claude:单独一个 Anthropic 端点
Claude 走 OpenAI 兼容的自定义端点也能用,但 LibreChat 在这种请求里不打cache_control 标记,只有 RuAPI 的自动缓存:新对话的第一轮最多只缓存系统提示,隔了超过 5 分钟再问时缓存已过期,整段聊天记录要重新计费。在 custom 下再加一项 provider: "anthropic",LibreChat 就会用 Anthropic 原生格式跟 Claude 通信,并自动开启提示词缓存(详见提示词缓存):
provider: "anthropic" 不走自动拉取模型列表。这个端点默认开启思考(Thinking),思考 token 按输出计费。
验证
在界面里选 RuAPI 供应商和一个模型,发条消息。有回复 + RuAPI 控制台 →「使用日志」有记录,说明通了。出问题时
RuAPI 供应商没出现
RuAPI 供应商没出现
- 确认
librechat.yaml已经通过docker-compose.override.yml挂进容器(「把 librechat.yaml 挂进容器」这一步)。 - 检查
librechat.yaml的缩进(YAML 对缩进敏感),以及这块是否在endpoints.custom下面。解析错误可以在docker compose logs api里看到。 - 确认改完后重启了容器。
报 401 或 404
报 401 或 404
- 401:
.env里的RUAPI_KEY要是完整的 RuAPI 密钥(sk-...),apiKey用${RUAPI_KEY}引用它。 - 404:OpenAI 兼容端点的
baseURL是带/v1的https://www.ruapi.ai/v1;provider: "anthropic"端点是不带/v1的https://www.ruapi.ai。
模型报错
模型报错
首次充值前只能用
claude-haiku-5-5、deepseek-flash 和 gpt-6-luna。错误码见错误。对话标题不生成
对话标题不生成
检查
titleConvo: true,以及 titleModel 指向的是可用模型。