1. 软件使用教程
速创 API
  • 文档说明
  • 新手必看！速创API 中转站
  • 软件使用教程
    • 安卓版 RikkaHub 接入速创API教程
    • (推荐)opencode使用教程
      • OpenCode 桌面版小白使用教程
      • 实操案例：OpenCode 桌面版辅助论文写作
    • Cherry studio使用教程
      • (推荐)电脑版Cherry Studio对接速创API实现简单对话教程
      • 安卓版Cherry Studio · 接入速创API教程
      • (进阶)电脑版Cherry Studio实现画图
      • (进阶)电脑版Cherry Studio实现agent操控电脑文件
      • 实操案例——写论文
  • 模型（Models）
    • 列出模型
      • 原生OpenAI格式
      • 原生Gemini格式
  • 聊天（Chat）
    • 原生OpenAI格式
      • ChatCompletions格式
      • Responses格式
    • 原生Gemini格式
      • Gemini文本聊天
      • Gemini媒体识别
    • 原生Claude格式
      POST
  • 图像（Images）
    • 原生OpenAI格式
      • 生成图像
      • 编辑图像
    • 通义千问格式
      • 生成图像
      • 编辑图像
    • Nano Banana
      • Gemini原生格式
      • OpenAI聊天格式
  • 视频（Videos）
    • Sora格式
      • 创建视频
      • 获取视频任务状态
      • 获取视频内容
    • 可灵格式
      • Kling 文生视频
      • 获取 Kling 文生视频任务状态
      • Kling 图生视频
      • 获取 Kling 图生视频任务状态
    • 即梦格式
      • 即梦视频生成
    • 创建视频生成任务
      POST
    • 获取视频生成任务状态
      GET
  • 嵌入（Embeddings）
    • 原生OpenAI格式
      POST
    • 原生Gemini格式
      POST
  • 补全（Completions）
    • 原生OpenAI格式
      POST
  • 音频（Audio）
    • 原生OpenAI格式
      • 音频转录
      • 音频翻译
      • 文本转语音
    • 原生Gemini格式
      POST
  • 实时语音（Realtime）
    • 原生OpenAI格式
  • 重排序（Rerank）
    • 文档重排序
  • 审查（Moderations）
    • 原生OpenAI格式
  • 未实现（Unimplemented）
    • 微调（Fine-tuning）
      • 列出微调任务 (未实现)
      • 创建微调任务 (未实现)
      • 获取微调任务详情 (未实现)
      • 取消微调任务 (未实现)
      • 获取微调任务事件 (未实现)
    • 文件（Files）
      • 列出文件 (未实现)
      • 上传文件 (未实现)
      • 获取文件信息 (未实现)
      • 删除文件 (未实现)
      • 获取文件内容 (未实现)
  • 数据模型
    • Schemas
      • User
      • Log
      • Model
      • Token
      • Usage
      • PageInfo
      • Channel
      • Redemption
      • ApiResponse
      • ModelsResponse
      • ErrorResponse
      • Message
      • MessageContent
      • Tool
      • ToolCall
      • GeminiModelsResponse
      • ChatCompletionResponse
      • ChatCompletionRequest
      • ChatCompletionStreamResponse
      • CompletionRequest
      • CompletionResponse
      • ResponseFormat
      • ResponsesRequest
      • ResponsesResponse
      • ResponsesStreamResponse
      • ClaudeRequest
      • ClaudeMessage
      • ClaudeResponse
      • EmbeddingRequest
      • EmbeddingResponse
      • ImageGenerationRequest
      • ImageEditRequest
      • ImageResponse
      • AudioTranscriptionRequest
      • AudioTranslationRequest
      • AudioTranscriptionResponse
      • SpeechRequest
      • RerankRequest
      • RerankResponse
      • VideoRequest
      • ModerationRequest
      • VideoResponse
      • ModerationResponse
      • VideoTaskResponse
      • GeminiRequest
      • VideoTaskMetadata
      • VideoTaskError
      • GeminiResponse
      • OpenAIVideo
      • OpenAIVideoError
  1. 软件使用教程

安卓版 RikkaHub 接入速创API教程

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

一、准备工作#

开始前需要准备：
1.
一部安卓手机；
2.
RikkaHub 安卓版；
3.
一个速创API账号和 API Key；
4.
速创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密钥#

1.
在浏览器中打开 https://api.suchuang.vip，注册并登录；
2.
进入“控制台”，确认钱包中有可用余额；
3.
打开“API 密钥”，添加一个新令牌；
4.
保存后复制生成的 API Key，密钥通常以 sk- 开头；
5.
打开“模型广场”，记下准备使用的模型 ID。
详细的注册和密钥创建方法请查看：新手必看！速创API 中转站
API Key 相当于账号调用凭证，请勿发送给陌生人，也不要在公开截图、群聊或代码仓库中泄露。

三、在 RikkaHub 中添加速创API#

步骤 1：打开侧边栏#

启动 RikkaHub，在聊天主页点击左上角的三横线按钮。
01-open-menu.jpg

步骤 2：进入设置#

在侧边栏底部点击六边形的“设置”按钮。
02-open-settings.jpg

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

在设置页找到“模型与服务”，点击“提供商”。
03-open-providers.jpg

步骤 4：添加提供商#

点击提供商页面右上角的 +。
04-add-provider.jpg

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

提供商类型选择 OpenAI，然后按下表填写：
配置项填写内容
名称速创API，也可以填写其他便于识别的名称
API Key在速创API控制台复制的 sk-... 密钥
API Base Urlhttps://api.suchuang.vip/v1
API 路径/chat/completions
是否启用开启
Response API关闭
“回传历史思考过程”可按需设置；不清楚时保持应用默认值即可。确认无误后点击“添加”。
05-provider-config.jpg
注意：API Base Url 已经包含 /v1，不要重复填写成 /v1/v1。本教程使用 Chat Completions 接口，因此 Response API 保持关闭。
添加成功后，提供商列表会出现“速创API”，并显示为“启用”。
06-provider-enabled.jpg

四、添加聊天模型#

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

步骤 1：进入模型页#

点击“速创API”进入详情页，再点击底部的“模型”。
07-open-models.jpg

步骤 2：添加新模型#

点击“添加新模型”。
08-add-model.jpg

步骤 3：填写模型信息#

以聊天模型为例：
1.
“模型 ID”必须与速创API“模型广场”中的 ID完全一致，不能自行修改大小写、空格或符号；
2.
“模型显示名称”可以与模型 ID相同，也可以填写一个方便识别的名称；
3.
“模型类型”选择“聊天”；
4.
“输入模态”至少勾选“文本”；模型支持识图时再勾选“图片”；
5.
“输出模态”选择“文本”；
6.
其他能力和高级参数不清楚时保持默认；
7.
点击右下角“添加”。
下图使用 gpt-5.6-sol 作为示例。实际配置时，请以速创API模型广场当前展示的模型 ID和能力为准。
09-chat-model-settings.jpg
不要仅根据模型名称猜测能力。如果模型本身不支持图片输入，却在 RikkaHub 中勾选了“图片”，发送图片时仍可能报错。

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

返回聊天主页，点击输入框左下角的模型图标。
12-model-picker.jpg
在弹出的列表中找到“速创API”，选择刚刚添加的聊天模型。选中的模型会高亮显示。
11-select-model.jpg
现在可以在输入框中发送一条简单消息，例如：
你好，请简单介绍一下你自己。
如果模型正常回复，说明速创API已经接入成功。

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

如果需要使用速创API的图片生成功能，可以继续在“速创API”提供商的模型页点击“添加新模型”，然后填写：
配置项填写内容
模型 IDgpt-image-2
模型显示名称gpt-image-2
模型类型图像
填写后点击“添加”。
10-image-model-settings.jpg
图像模型与聊天模型类型不同，通常不会出现在普通聊天模型列表中。请在 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模型广场完全一致。配置完成后，请先发送一条简单文本消息测试，再按需开启图片输入、工具调用等高级能力。
修改于 2026-08-17 04:34:36
上一页
新手必看！速创API 中转站
下一页
OpenCode 桌面版小白使用教程
Built with