安卓版 RikkaHub 接入速创API教程

该教程为速创API原创，转载请注明出处。

本文以 RikkaHub 安卓版为例，演示如何添加速创API提供商、配置聊天模型，并开始对话。文末还介绍了如何添加 gpt-image-2 图像模型。

一、准备工作

开始前需要准备：

一部安卓手机；

RikkaHub 安卓版；

一个速创API账号和 API Key；

速创API账户中有可用余额。

RikkaHub 官方下载地址：

官网（推荐）：https://rikka-ai.com/download

Google Play：https://play.google.com/store/apps/details?id=me.rerere.rikkahub

GitHub：https://github.com/rikkahub/rikkahub

请尽量从官方渠道下载。不同版本的界面可能略有差异，但配置项目基本相同。

二、获取速创API密钥

在浏览器中打开 https://api.suchuang.vip，注册并登录；

进入“控制台”，确认钱包中有可用余额；

打开“API 密钥”，添加一个新令牌；

保存后复制生成的 API Key，密钥通常以 sk- 开头；

打开“模型广场”，记下准备使用的模型 ID。

详细的注册和密钥创建方法请查看：新手必看！速创API 中转站

API Key 相当于账号调用凭证，请勿发送给陌生人，也不要在公开截图、群聊或代码仓库中泄露。

三、在 RikkaHub 中添加速创API

步骤 1：打开侧边栏

启动 RikkaHub，在聊天主页点击左上角的三横线按钮。

步骤 2：进入设置

在侧边栏底部点击六边形的“设置”按钮。

步骤 3：打开“提供商”

在设置页找到“模型与服务”，点击“提供商”。

步骤 4：添加提供商

点击提供商页面右上角的 +。

步骤 5：填写提供商配置

提供商类型选择 OpenAI，然后按下表填写：

配置项	填写内容
名称	`速创API`，也可以填写其他便于识别的名称
API Key	在速创API控制台复制的 `sk-...` 密钥
API Base Url	`https://api.suchuang.vip/v1`
API 路径	`/chat/completions`
是否启用	开启
Response API	关闭

“回传历史思考过程”可按需设置；不清楚时保持应用默认值即可。确认无误后点击“添加”。

注意：API Base Url 已经包含 /v1，不要重复填写成 /v1/v1。本教程使用 Chat Completions 接口，因此 Response API 保持关闭。

添加成功后，提供商列表会出现“速创API”，并显示为“启用”。

四、添加聊天模型

添加提供商后，还需要手动添加要使用的模型。

步骤 1：进入模型页

点击“速创API”进入详情页，再点击底部的“模型”。

步骤 2：添加新模型

点击“添加新模型”。

步骤 3：填写模型信息

以聊天模型为例：

“模型 ID”必须与速创API“模型广场”中的 ID完全一致，不能自行修改大小写、空格或符号；

“模型显示名称”可以与模型 ID相同，也可以填写一个方便识别的名称；

“模型类型”选择“聊天”；

“输入模态”至少勾选“文本”；模型支持识图时再勾选“图片”；

“输出模态”选择“文本”；

其他能力和高级参数不清楚时保持默认；

点击右下角“添加”。

下图使用 gpt-5.6-sol 作为示例。实际配置时，请以速创API模型广场当前展示的模型 ID和能力为准。

不要仅根据模型名称猜测能力。如果模型本身不支持图片输入，却在 RikkaHub 中勾选了“图片”，发送图片时仍可能报错。

五、选择模型并开始聊天

返回聊天主页，点击输入框左下角的模型图标。

在弹出的列表中找到“速创API”，选择刚刚添加的聊天模型。选中的模型会高亮显示。

现在可以在输入框中发送一条简单消息，例如：

你好，请简单介绍一下你自己。

如果模型正常回复，说明速创API已经接入成功。

六、可选：添加 `gpt-image-2` 图像模型

如果需要使用速创API的图片生成功能，可以继续在“速创API”提供商的模型页点击“添加新模型”，然后填写：

配置项	填写内容
模型 ID	`gpt-image-2`
模型显示名称	`gpt-image-2`
模型类型	图像

填写后点击“添加”。

图像模型与聊天模型类型不同，通常不会出现在普通聊天模型列表中。请在 RikkaHub 的图片生成相关功能中选择它。模型可用性和计费标准请以速创API模型广场为准。

七、常见问题

1. 提示 401、Unauthorized 或 API Key 无效

检查 API Key 是否完整，前后不要带空格；

确认复制的是速创API控制台中的有效密钥；

检查令牌是否已被禁用或删除。

2. 提示 404 或接口不存在

请逐项确认：

API Base Url：https://api.suchuang.vip/v1
API 路径：/chat/completions
Response API：关闭

不要把地址写成 https://api.suchuang.vip/v1/v1。

3. 提示模型不存在

模型 ID填写错误，或者当前令牌分组不支持该模型。请到速创API“模型广场”复制准确的模型 ID，并检查令牌分组。

4. 一直加载但没有回复

检查手机网络是否正常；

检查速创API账户余额；

换一个当前可用的聊天模型测试；

新建对话后重试；

检查模型类型是否误选为“图像”或“嵌入”。

5. 无法发送图片

只有支持视觉输入的模型才能识别图片。确认模型本身支持图片后，再到模型设置中勾选“输入模态 > 图片”。

6. 更新 RikkaHub 后界面与截图不同

RikkaHub 更新较快，按钮位置和名称可能变化。核心路径仍然是：

设置 > 提供商 > 添加 OpenAI 提供商 > 填写密钥和地址 > 添加模型 > 返回聊天页选择模型

八、配置速查

提供商类型：OpenAI
名称：速创API
API Base Url：https://api.suchuang.vip/v1
API 路径：/chat/completions
Response API：关闭
聊天模型类型：聊天
图像模型类型：图像

模型 ID必须与速创API模型广场完全一致。配置完成后，请先发送一条简单文本消息测试，再按需开启图片输入、工具调用等高级能力。

安卓版 RikkaHub 接入速创API教程

一、准备工作#

二、获取速创API密钥#

三、在 RikkaHub 中添加速创API#

步骤 1：打开侧边栏#

步骤 2：进入设置#

步骤 3：打开“提供商”#

步骤 4：添加提供商#

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

四、添加聊天模型#

步骤 1：进入模型页#

步骤 2：添加新模型#

步骤 3：填写模型信息#

五、选择模型并开始聊天#

六、可选：添加 gpt-image-2 图像模型#

七、常见问题#

1. 提示 401、Unauthorized 或 API Key 无效#

2. 提示 404 或接口不存在#

3. 提示模型不存在#

4. 一直加载但没有回复#

5. 无法发送图片#

6. 更新 RikkaHub 后界面与截图不同#

八、配置速查#