安卓客户端快速接入

通过 CoffeeRouter 令牌管理页快速接入 Chatbox 和 RikkaHub 安卓客户端，了解正确地址、安全令牌操作和官方下载入口。

通过 CoffeeRouter 令牌管理页，可以快速接入 Chatbox 和 RikkaHub 两款 Android 客户端。两种方式使用的地址结构不同，请按照对应客户端的说明操作。

接入前准备

  • 已登录 CoffeeRouter 控制台。
  • 已安装准备使用的 Android 客户端，或可以访问下方官方下载页。
  • 当前令牌需要支持至少一个聊天模型。

统一入口

1. 登录控制台登录 CoffeeRouter 控制台。
2. 打开令牌管理进入「令牌管理」页面。
3. 点击聊天找到已有令牌，点击该行的「聊天」。
4. 选择安卓客户端在下拉选项中选择「安卓客户端」。
5. 选择接入方式在弹窗中选择 Chatbox 或 RikkaHub。

如果当前令牌只支持图片或视频模型，Chatbox 和 RikkaHub 均不可用，请改选支持聊天模型的令牌。

官方下载

请只从客户端官方网站下载安装包：

Chatbox

Chatbox 支持通过 Provider Deep Link 导入 OpenAI 兼容服务。CoffeeRouter 会生成导入数据，但公开文档不会展示包含令牌的完整链接。

Chatbox 配置参数

字段必须填写的值
API Hosthttps://www.coffeerouter.ai
API Path/v1/chat/completions
API Keysk-••••••••

一键导入步骤

  1. 在安卓客户端弹窗中选择 Chatbox。
  2. 选择一个主模型。
  3. 点击 「打开 Chatbox」。
  4. 浏览器提示打开应用时选择允许，Chatbox 会导入 CoffeeRouter 的 OpenAI 兼容服务配置。
  5. 在 Chatbox 中确认服务商和主模型后开始对话。

如果没有自动打开，请先从上方官方入口安装或更新 Chatbox，然后返回 CoffeeRouter 重试。

RikkaHub

RikkaHub 支持通过二维码导入提供商配置。二维码包含令牌，只应在自己的设备之间使用。

RikkaHub 配置参数

字段必须填写的值
Base URLhttps://www.coffeerouter.ai/v1
Chat Completions Path/chat/completions
API Keysk-••••••••

二维码导入步骤

  1. 在安卓客户端弹窗中选择 RikkaHub。
  2. 选择主模型并生成配置二维码。
  3. 使用 RikkaHub 的二维码导入功能扫描屏幕上的二维码。
  4. 如果 CoffeeRouter 控制台和 RikkaHub 在同一台 Android 设备上，请使用弹窗提供的保存功能把二维码临时保存到本机，再在 RikkaHub 中从相册导入。
  5. 导入成功后立即删除本地二维码文件，并确认它没有同步到云相册。

安全提示

  • 不要公开 Chatbox 导入链接或 RikkaHub 二维码。
  • 不要在工单、群聊、网盘或公开仓库中上传二维码。
  • 同设备导入 RikkaHub 时，仅使用本机临时文件；导入后立即删除，并关闭云相册同步。
  • 如果怀疑令牌已泄露，请立即在 CoffeeRouter 的「令牌管理」中禁用或删除旧令牌，再生成新令牌并重新导入。

常见问题

为什么 Chatbox 地址不带 /v1？

Chatbox 把 API Host 和 API Path 分开保存。Host 必须是 https://www.coffeerouter.ai，Path 必须是 /v1/chat/completions，两者组合后才是完整接口地址。

为什么 RikkaHub 地址需要 /v1？

RikkaHub 的 Base URL 是 https://www.coffeerouter.ai/v1，而 Chat Completions Path 只填写 /chat/completions。两者组合后同样指向 CoffeeRouter 的聊天补全接口。

点击后没有打开客户端怎么办？

先确认客户端已经从官方渠道安装或更新。Chatbox 请返回 CoffeeRouter 再次点击「打开 Chatbox」，并允许浏览器打开应用；RikkaHub 可以改用保存二维码后从相册导入。

如何撤销或更换令牌？

在 CoffeeRouter 的「令牌管理」中禁用或删除旧令牌，然后创建新令牌，并为 Chatbox 或 RikkaHub 重新导入配置。