跳转到主要内容
LibreChat 是个自托管、类 ChatGPT 的 Web 界面,支持多家供应商。RuAPI 通过 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 通信,并自动开启提示词缓存(详见提示词缓存):
Claude 模型要手动列:provider: "anthropic" 不走自动拉取模型列表。这个端点默认开启思考(Thinking),思考 token 按输出计费。

验证

在界面里选 RuAPI 供应商和一个模型,发条消息。有回复 + RuAPI 控制台 →「使用日志」有记录,说明通了。

出问题时

  • 确认 librechat.yaml 已经通过 docker-compose.override.yml 挂进容器(「把 librechat.yaml 挂进容器」这一步)。
  • 检查 librechat.yaml 的缩进(YAML 对缩进敏感),以及这块是否在 endpoints.custom 下面。解析错误可以在 docker compose logs api 里看到。
  • 确认改完后重启了容器。
  • 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 指向的是可用模型。