RikkaHub 接入中转 API 教程：安卓 AI 聊天客户端配置

一、RikkaHub 是什么

RikkaHub 是一款开源的安卓 AI 聊天客户端，支持接入 Anthropic（Claude）、OpenAI（GPT）、Google（Gemini）等多种模型渠道。把它的 Provider（提供商） 指向中转网关、填入 sk- 密钥，即可用平台额度调用各系列模型，按 token 计费。

二、准备工作

1. 登录极智API控制台，在「API 密钥」创建 sk-xxxxxx 密钥（只显示一次，请保存）。
2. 确认要用的模型 slug（如 gemini-3.7-flash、claude-sonnet-5、gpt-5.5）。可在控制台「令牌」页右上角「模型 ID」查看。
3. 确认网关地址：https://www.relay-api.com。

三、在 RikkaHub 里配置

打开 RikkaHub →「设置」→「提供商」→ 右上角「+」新增，按要用的模型选择 Provider 类型：

① 调用 Gemini（Google 类型，推荐）

Provider 类型 : Google / Gemini
Base URL      : https://www.relay-api.com/v1beta
API Key       : sk-你的密钥
模型 ID        : gemini-3.7-flash

Base URL 必须带 /v1beta。RikkaHub 会在 Base URL 后面自动拼接 /models/{模型}:generateContent，若漏掉 /v1beta，请求会打到 /models/... 从而返回 404（页面找不到）。

② 调用 Claude（Anthropic 类型）

Provider 类型 : Anthropic / Claude
Base URL      : https://www.relay-api.com
API Key       : sk-你的密钥
模型 ID        : claude-sonnet-5

Anthropic 类型的 Base URL 不要再加 /v1，客户端会自己补上 /v1/messages，重复写会变成 /v1/v1/messages。

③ 调用 GPT（OpenAI 兼容类型）

Provider 类型 : OpenAI 兼容 / OpenAI Compatible
Base URL      : https://www.relay-api.com/v1
API Key       : sk-你的密钥
模型 ID        : gpt-5.5

四、接口地址对照

模型分组	Provider 类型	Base URL	协议
Gemini	Google / Gemini	https://www.relay-api.com/v1beta	Google generateContent
Claude	Anthropic	https://www.relay-api.com	Anthropic Messages
GPT	OpenAI 兼容	https://www.relay-api.com/v1	OpenAI Chat Completions

五、重点：模型按分组隔离，不能跨组调用

本站三种协议是各自独立的原生入口，模型按分组隔离：

• Gemini 分组的模型（gemini-3.7-flash 等）只能走 Google / Gemini 类型 + /v1beta。
• 把 Gemini 模型名填到 Anthropic 类型，会返回 400 未启用或不存在 Claude 模型: gemini-xxx。
• 把 Gemini 模型名填到 OpenAI 类型，会返回 400 未启用或不存在 OpenAI 模型: gemini-xxx。

所以「模型 ID」与「Provider 类型」必须匹配：用哪个分组的模型，就选对应的 Provider 类型。

六、常见问题排查

现象	原因与处理
返回 404（网页/HTML）	Base URL 漏了版本后缀（如 Gemini 少写 /v1beta），请求打到了不存在的路径。补上 /v1beta 或 /v1 即可。
路径出现 /v1beta/v1beta/ 或 /v1/v1/	Base URL 重复写了版本号。Base URL 里只写一次。
400 未启用或不存在 Claude/OpenAI 模型: gemini-xxx	模型分组与 Provider 类型不匹配——把 Gemini 模型填到了 Claude/OpenAI 类型。换成 Google / Gemini 类型。
401 / 403	密钥无效、未启用、余额不足，或该令牌无权访问此路线/模型。确认密钥与账户余额。
400 Request contains an invalid argument	上游对个别参数（如思考等级大小写、工具调用 tools）的校验；偶发出现多属上游短时波动，重试即可。
拉取模型列表失败	部分客户端对中转返回的模型清单解析较严格，改用「手动填写模型 ID」即可。

七、安全建议

• 密钥不要写进公开仓库或截图，建议用环境变量或本地安全保存。
• 给每台设备或每个工具单独建一个密钥，便于统计用量与随时停用。