RikkaHub 配置API中转平台文档教程

# RikkaHub 配置教程

> 适用端：**仅安卓手机**（iOS 暂不支持）  
> 客户端官网：<https://rikka-ai.com/>  
> 中转平台地址：`https://api.zaimod.com`

---

## 一、准备工作

开始配置前，先把这几项信息准备好，配置时直接照抄。

| 项目           | 取值 / 说明                                                         |
| ------------ | --------------------------------------------------------------- |
| 客户端          | RikkaHub 安卓版，从官网 <https://rikka-ai.com/> 下载安装                   |
| API Base Url | `https://api.zaimod.com/v1`                                      |
| API 路径       | `/chat/completions`                                             |
| 完整接口地址       | `https://api.zaimod.com/v1/chat/completions`（Base Url + 路径，无需手填） |
| API Key      | 在 `https://api.zaimod.com` 控制台创建，形如 `sk-xxxxxxxx`，请提前保存          |
| 模型名称         | 按平台模型列表填写，如 `gpt-4o`、`deepseek-chat` 等                          |

> 关键点：**Base Url 末尾要带 `/v1`**，而 API 路径只填 `/chat/completions`。两处各写一段，拼起来才是完整接口；若在 Base Url 里已经带了 `/v1`，路径中就不要再重复写 `/v1`。

---

## 二、操作步骤

### 步骤 1：打开侧边栏

打开 RikkaHub，在聊天页点击**左上角的菜单图标**（三条横线），展开侧边栏。

![](/uploads/editor/20261031/img_6ae5e3b9d1c116.19862658.png)

---

### 步骤 2：进入设置

侧边栏拉到底部，点击 **设置**（齿轮图标）。

![](/uploads/editor/20261031/img_6ae5e3c35cf181.05378644.png)

---

### 步骤 3：进入「提供商」

在设置页的 **模型与服务** 分组中，点击 **提供商**（描述为"配置 AI 提供商"）。

![](/uploads/editor/20261031/img_6ae5e3cb88fe38.98814393.png)

---

### 步骤 4：新增一个提供商

进入提供商列表，点击**右上角的 +**，新增自定义提供商。

![](/uploads/editor/20261031/img_6ae5e3d6b944f1.75516134.png)

---

### 步骤 5：填写提供商配置

新增后会打开配置页，顶部先选择接口类型为 **OpenAI**（OpenAI / Google / Claude 三个标签页），然后按下表逐项填写：

| 字段           | 填写内容                                             |
| ------------ | ------------------------------------------------ |
| 是否启用         | **勾选**（不勾选则该提供商不生效）                              |
| 名称           | 自定义，便于识别，如 `cxhao` 或 `中转API`                     |
| API Key      | 你的 Key，`sk-` 开头，**不要带 `Bearer ` 前缀**，直接粘贴 Key 本身 |
| API Base Url | `https://api.zaimod.com/v1`                       |
| API 路径       | `/chat/completions`                              |
| Response API | **不勾选**（保持 Chat Completions 接口）                  |
| 获取账户余额       | 建议**不勾选**（中转平台通常不提供余额查询接口，勾选可能报错）                |

填完点击底部 **保存**。

![](/uploads/editor/20261031/img_6ae5e3e565fbf7.01975970.png)

> 常见错误：把 `https://api.zaimod.com` 填进 Base Url 却漏了 `/v1`，保存后测试会返回 404；反之在 API 路径里写成 `/v1/chat/completions` 也会 404，两处只能有一处出现 `/v1`。

---

### 步骤 6：添加模型

保存后，点击底部导航切到 **模型** 页面，再点击 **+ 添加模型**。

RikkaHub 会自动拉取该提供商下的可用模型列表（列表号即可用数量）。

![](/uploads/editor/20261031/img_6ae5e3f0841203.12126333.png)

---

### 步骤 7：选择需要的模型

在模型列表中找到要用的模型，点击右侧 **+** 加入。

- 模型较多时，用底部 **输入模型名称筛选** 搜索框按名称过滤，如输入 `gpt` 或 `deepseek`。
- 可添加多个模型，后续在聊天页随时切换。

![](/uploads/editor/20261031/img_6ae5e3fa1b2c45.18123417.png)

---

### 步骤 8：切换模型并开始对话

返回聊天页，点击**输入框左下角的模型按钮**，选择刚添加的模型，即可开始对话。

输入问题后，能收到模型回复并显示 token 用量，说明配置成功。

![](/uploads/editor/20261031/img_6ae5e40367b439.81577986.png)

---

## 三、配置速查表

| 参数           | 值                                           |
| ------------ | ------------------------------------------- |
| 提供商类型        | OpenAI                                      |
| 是否启用         | 勾选                                          |
| API Key      | `sk-你的APIKey`（不带 `Bearer`）                  |
| API Base Url | `https://api.zaimod.com/v1`                  |
| API 路径       | `/chat/completions`                         |
| 完整接口         | `https://api.zaimod.com/v1/chat/completions` |
| Response API | 不勾选                                         |
| 获取账户余额       | 不勾选                                         |

---

## 四、常见问题

| 现象                    | 原因与处理                                                                         |
| --------------------- | ----------------------------------------------------------------------------- |
| 保存后模型列表为空             | Key 或 Base Url 有误，请求未通过鉴权。检查 Key 是否完整、Base Url 是否为 `https://api.zaimod.com/v1` |
| `401` / Invalid token | Key 错误：多复制了空格、Key 已过期或被删除；注意 Key 栏不要填 `Bearer ` 前缀                            |
| `404` / Not Found     | `/v1` 位置写错：Base Url 带 `/v1` 时，路径只能写 `/chat/completions`                       |
| 一直转圈或连接失败             | 手机网络问题；可在设置 → 数据存储/网络代理中配置代理后再试                                               |
| 对话报模型不存在              | 模型名与平台可用列表不一致，回到模型列表重新添加，或手动填入准确名称                                            |
| 勾选「获取账户余额」后报错         | 中转平台无对应余额接口，取消勾选该项即可                                                          |

---

## 附：接口地址变更对照

| 位置           | 原地址                                          | 现地址                                         |
| ------------ | -------------------------------------------- | ------------------------------------------- |
| API Base Url | `https://api.openlux.ai/v1`                  | `https://api.zaimod.com/v1`                  |
| 完整接口         | `https://api.zaimod.com/v1/chat/completions` | `https://api.zaimod.com/v1/chat/completions` |

> Key 由新平台签发，迁移后请在 `https://api.zaimod.com` 重新生成，并替换提供商配置中的 API Key。

上一篇：扣子（Coze）工作流调用 API 教程{else}上一篇：没有了下一篇：Codex 配置API接入教程{else}下一篇：没有了