> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# LibreChat

> 如何通过 librechat.yaml 把 RuAPI 作为自定义端点加进 LibreChat

[LibreChat](https://www.librechat.ai) 是个自托管、类 ChatGPT 的 Web 界面,支持多家供应商。RuAPI 通过 `librechat.yaml` 里的\*\*自定义端点(custom endpoint)\*\*加入 —— 配好之后,RuAPI 的所有模型都会出现在选择列表里。

## 前置

<Steps>
  <Step title="RuAPI 账号和密钥">
    控制台 →\*\*「令牌」\*\*→ 创建 `sk-...` 密钥。余额用 USDT 充 —— 见[充值](/zh/topup)。
  </Step>

  <Step title="跑起来的 LibreChat">
    按 [LibreChat 文档](https://www.librechat.ai/docs)安装(一般用 Docker)。
  </Step>
</Steps>

## 配置

<Steps>
  <Step title="在 .env 里加密钥">
    ```bash theme={null}
    RUAPI_KEY=sk-你的密钥
    ```
  </Step>

  <Step title="在 librechat.yaml 里描述端点">
    ```yaml theme={null}
    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"
    ```
  </Step>

  <Step title="重启 LibreChat">
    重新加载配置(重启容器)。界面里会出现 **RuAPI** 这个供应商。
  </Step>
</Steps>

<Note>
  `fetch: true` 会通过 `/v1/models` 自动拉取模型列表。不想自动拉取就去掉 `fetch`,在 `default` 里手动列出要用的 ID。
</Note>

## 验证

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

## 出问题时

<AccordionGroup>
  <Accordion title="RuAPI 供应商没出现">
    * 检查 `librechat.yaml` 的缩进(YAML 对缩进敏感),以及这块是否在 `endpoints.custom` 下面。
    * 确认改完后容器重新加载了配置。
  </Accordion>

  <Accordion title="模型列表空 / 401">
    * `baseURL` 要是带 `/v1` 的 `https://www.ruapi.ai/v1`。
    * `.env` 里的 `RUAPI_KEY` 要是 RuAPI 令牌(`sk-...`),`apiKey` 用 `${RUAPI_KEY}` 引用它。
  </Accordion>

  <Accordion title="对话标题不生成">
    检查 `titleConvo: true`,以及 `titleModel` 指向的是可用模型。
  </Accordion>
</AccordionGroup>