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

# RikkaHub

> 在 RikkaHub 中配置 AIHubMix，添加并使用 AIHubMix 模型。

RikkaHub 是一款支持多个 LLM Provider 的 Android 应用。

下载链接：[RikkaHub Releases](https://github.com/rikkahub/rikkahub/releases)

## 准备工作

* 安装并打开 RikkaHub。
* 在 [AIHubMix 控制台](https://aihubmix.com/token) 创建 API Key。

## 配置 AIHubMix

### 1. 打开 Providers

在聊天页点击左上角菜单按钮，打开侧栏后点击底部的设置按钮。在设置页面点击 **Providers**。

<Columns cols={3}>
  <div style={{ marginTop: "20px" }}>
    <img src="https://mintcdn.com/aihubmix/4kxv71fdbSWrqPvM/public/cn/RikkaHub-new-01.jpg?fit=max&auto=format&n=4kxv71fdbSWrqPvM&q=85&s=1f3bea0bc009f777eb6a1de939e6eb9b" alt="打开侧栏" width="1260" height="2800" data-path="public/cn/RikkaHub-new-01.jpg" />
  </div>

  <img src="https://mintcdn.com/aihubmix/4kxv71fdbSWrqPvM/public/cn/RikkaHub-new-02.jpg?fit=max&auto=format&n=4kxv71fdbSWrqPvM&q=85&s=c47b8d74a87fa3b0cd7077a0990fbf7a" alt="打开设置" width="1260" height="2800" data-path="public/cn/RikkaHub-new-02.jpg" />

  <img src="https://mintcdn.com/aihubmix/4kxv71fdbSWrqPvM/public/cn/RikkaHub-new-03.jpg?fit=max&auto=format&n=4kxv71fdbSWrqPvM&q=85&s=4d34165a85e39a377cb813a17a7f43f8" alt="进入 Providers" width="1260" height="2800" data-path="public/cn/RikkaHub-new-03.jpg" />
</Columns>

### 2. 填写并保存 Provider 信息

在 Provider 列表中点击 **AiHubMix**，填写以下内容：

* **API Key**：填入在 AIHubMix 控制台创建的 API Key。
* **API Base Url**：填 `https://aihubmix.com/v1`。主地址暂时不可用时，使用备用地址 `https://api.inferera.com/v1`。
* **API Path**：保持默认的 `/chat/completions`，无需修改。
* **Enable**：开启。
* **Response API**：保持关闭。

填写完成后，点击页面右下角的 **Save** 保存配置。

<Columns cols={3}>
  <div style={{ marginTop: "20px" }}>
    <img src="https://mintcdn.com/aihubmix/4kxv71fdbSWrqPvM/public/cn/RikkaHub-new-04.jpg?fit=max&auto=format&n=4kxv71fdbSWrqPvM&q=85&s=60320ac9f3f2921878698a7bd4cfc92a" alt="选择 AiHubMix Provider" width="1260" height="2800" data-path="public/cn/RikkaHub-new-04.jpg" />
  </div>

  <img src="https://mintcdn.com/aihubmix/4kxv71fdbSWrqPvM/public/cn/RikkaHub-new-05.jpg?fit=max&auto=format&n=4kxv71fdbSWrqPvM&q=85&s=bd493d35fd4730046d04ffb73389d63a" alt="填写 API Key 和地址" width="1260" height="2800" data-path="public/cn/RikkaHub-new-05.jpg" />

  <img src="https://mintcdn.com/aihubmix/4kxv71fdbSWrqPvM/public/cn/RikkaHub-new-06.jpg?fit=max&auto=format&n=4kxv71fdbSWrqPvM&q=85&s=3f31f05f792e2494366b101522a3c29b" alt="保存 Provider 配置" width="1260" height="2800" data-path="public/cn/RikkaHub-new-06.jpg" />
</Columns>

## 添加模型

切换到 **Models** 标签页后，可以点击 **Add New Model** 自定义添加模型；也可以点击左侧的模型列表按钮，直接在列表中选择模型。

在模型列表中，可以按名称筛选模型，点击模型右侧的 **+** 添加；需要添加全部模型时，点击 **Select All**。添加完成后，可返回模型管理页面查看和管理已添加的模型。

<Columns cols={3}>
  <div style={{ marginTop: "20px" }}>
    <img src="https://mintcdn.com/aihubmix/4kxv71fdbSWrqPvM/public/cn/RikkaHub-new-07.jpg?fit=max&auto=format&n=4kxv71fdbSWrqPvM&q=85&s=6c5fbe39982114163ef0f4fec5b4ed58" alt="打开模型管理" width="1260" height="2800" data-path="public/cn/RikkaHub-new-07.jpg" />
  </div>

  <img src="https://mintcdn.com/aihubmix/4kxv71fdbSWrqPvM/public/cn/RikkaHub-new-08.jpg?fit=max&auto=format&n=4kxv71fdbSWrqPvM&q=85&s=219a522772e54109e799a84b70b72bda" alt="在模型列表中添加模型" width="1260" height="2800" data-path="public/cn/RikkaHub-new-08.jpg" />

  <img src="https://mintcdn.com/aihubmix/4kxv71fdbSWrqPvM/public/cn/RikkaHub-new-09.jpg?fit=max&auto=format&n=4kxv71fdbSWrqPvM&q=85&s=9a9bedc300e20e99f3d16ef22fc5358d" alt="管理已添加的模型" width="1260" height="2800" data-path="public/cn/RikkaHub-new-09.jpg" />
</Columns>

## 测试连接

模型添加完成后，切换回 **Configuration** 标签页，点击页面底部左侧的连接测试按钮。

在弹出的模型列表中选择一个已添加的模型，然后点击 **Test**。非流式、流式和工具调用均显示通过，说明连接配置正常。

<Columns cols={3}>
  <div style={{ marginTop: "20px" }}>
    <img src="https://mintcdn.com/aihubmix/4kxv71fdbSWrqPvM/public/cn/RikkaHub-new-10.jpg?fit=max&auto=format&n=4kxv71fdbSWrqPvM&q=85&s=7864011e3534b1c6c8a6ac13668e934a" alt="打开连接测试" width="1260" height="2800" data-path="public/cn/RikkaHub-new-10.jpg" />
  </div>

  <img src="https://mintcdn.com/aihubmix/4kxv71fdbSWrqPvM/public/cn/RikkaHub-new-11.jpg?fit=max&auto=format&n=4kxv71fdbSWrqPvM&q=85&s=9fbbc5efed1b36aaabe2ae8d7adbe7e6" alt="选择测试模型" width="1260" height="2800" data-path="public/cn/RikkaHub-new-11.jpg" />

  <img src="https://mintcdn.com/aihubmix/4kxv71fdbSWrqPvM/public/cn/RikkaHub-new-12.jpg?fit=max&auto=format&n=4kxv71fdbSWrqPvM&q=85&s=13beb0dbdd93bb295e341d7508cc0d2c" alt="查看连接测试结果" width="1260" height="2800" data-path="public/cn/RikkaHub-new-12.jpg" />
</Columns>

## 选择模型并验证

回到聊天页，打开左下角模型选择器，在 **AiHubMix** 分类中选择已添加的模型。

发送一条消息，能够正常收到回复即表示配置成功。

<Columns cols={3}>
  <div style={{ marginTop: "20px" }}>
    <img src="https://mintcdn.com/aihubmix/4kxv71fdbSWrqPvM/public/cn/RikkaHub-new-13.jpg?fit=max&auto=format&n=4kxv71fdbSWrqPvM&q=85&s=e37181a097826a8187abe9dd235e9eec" alt="打开左下角模型选择器" width="1260" height="2800" data-path="public/cn/RikkaHub-new-13.jpg" />
  </div>

  <img src="https://mintcdn.com/aihubmix/4kxv71fdbSWrqPvM/public/cn/RikkaHub-new-14.jpg?fit=max&auto=format&n=4kxv71fdbSWrqPvM&q=85&s=2bf6496ec197b056d43f35cc044f0c05" alt="选择 AIHubMix 模型" width="1260" height="2800" data-path="public/cn/RikkaHub-new-14.jpg" />

  <img src="https://mintcdn.com/aihubmix/4kxv71fdbSWrqPvM/public/cn/RikkaHub-new-15.jpg?fit=max&auto=format&n=4kxv71fdbSWrqPvM&q=85&s=05989b63e6115df9151950ea82d6e014" alt="验证模型回复" width="1260" height="2800" data-path="public/cn/RikkaHub-new-15.jpg" />
</Columns>

## 常见问题

**API Base Url 要填完整请求地址吗？**

不需要。**API Base Url** 填到 `/v1`，`/chat/completions` 保持在 **API Path** 的默认值中。

**添加后在模型选择器中找不到模型怎么办？**

确认 Provider 已开启并保存，再检查 **Models** 标签页中是否已添加该模型。必要时返回 Provider 配置页重新测试连接。

**请求失败怎么办？**

检查 API Key、API Base Url 和模型是否正确。主地址暂时不可用时，将 **API Base Url** 更换为 `https://api.inferera.com/v1`。

更新时间：2026-07-17