跳转到主要内容
LibreChat 是个自托管、类 ChatGPT 的 Web 界面,支持多家供应商。RuAPI 通过 librechat.yaml 里的**自定义端点(custom endpoint)**加入 —— 配好之后,RuAPI 的所有模型都会出现在选择列表里。

​
前置

1

RuAPI 账号和密钥

控制台 →**「令牌」**→ 创建 sk-... 密钥。余额用 USDT 充 —— 见充值。
2

跑起来的 LibreChat

按 LibreChat 文档安装(一般用 Docker)。

​
配置

1

在 .env 里加密钥

RUAPI_KEY=sk-你的密钥
2

在 librechat.yaml 里描述端点

endpoints:
  custom:
    - name: "RuAPI"
      apiKey: "${RUAPI_KEY}"
      baseURL: "https://www.ruapi.ai/v1"   # 带 /v1
      models:
        default: ["claude-opus-4-8"]        # 精确名称见价格页
        fetch: true                          # 通过 /v1/models 拉取整个目录
      titleConvo: true
      titleModel: "claude-opus-4-8"
3

重启 LibreChat

重新加载配置(重启容器)。界面里会出现 RuAPI 这个供应商。
fetch: true 会通过 /v1/models 自动拉取模型列表。不想自动拉取就去掉 fetch,在 default 里手动列出要用的 ID。

​
验证

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

​
出问题时

  • 检查 librechat.yaml 的缩进(YAML 对缩进敏感),以及这块是否在 endpoints.custom 下面。
  • 确认改完后容器重新加载了配置。
  • baseURL 要是带 /v1 的 https://www.ruapi.ai/v1。
  • .env 里的 RUAPI_KEY 要是 RuAPI 令牌(sk-...),apiKey 用 ${RUAPI_KEY} 引用它。
检查 titleConvo: true,以及 titleModel 指向的是可用模型。