跳到正文

在RikkaHub配置openqiao指南 ​

RikkaHub 是一款功能丰富的 Android AI 助手客户端,支持多种大语言模型服务商的接入。通过与开桥的集成,你可以在 RikkaHub 中访问开桥平台上聚合的海量模型资源,享受更灵活的模型选择和更优惠的价格。

兼容性说明

开桥完全支持 OpenAI Chat Completions 协议,可以平滑集成到 RikkaHub 等支持自定义 OpenAI 兼容端点的客户端中。只需添加开桥作为模型提供商,即可使用所有支持 OpenAI 协议的模型。

配置方案 ​

步骤 1:下载并安装 RikkaHub ​

前往 RikkaHub GitHub Releases 下载最新版本的 APK 并安装到你的 Android 设备上。

步骤 2:添加开桥模型提供商 ​

  1. 打开 RikkaHub,进入 设置

  2. 点击providers,点击右上方"+"添加provider

  3. 选择添加一个 OpenAI 兼容 类型的提供商,并填写以下信息:

    • 名称: 开桥(或你偏好的名称)
    • API Key: 填入你的开桥 API Key(订阅制api格式为 sk-ss-v1-xxx,Pay As You Go API Key格式为sk-ai-v1-xxx)
    • API Base URL: https://openqiao.com/api/v1
    • API Path:/chat/completions
  4. 点击右下角的models,会发现在下方的add new model的左侧有个图标显示有数字角标(代表拉取过来的模型,如果没有,请检查网络设置或者是按照openai兼容来配置),点击该图标,搜索并添加所需要的模型,保存后返回即可使用

  5. 注意通过openai兼容格式拉取模型不包含gemini生图模型,如若不想配置gemini生图模型,请忽略如下几步

  6. 为了配置gemini生图模型,请点击models页面的add new model,在basic settings配置如下:

    • model ID: 例如googlelgemini-3.1-flash-image-preview(模型id可到https://openqiao.com/models?sort=newest去复制相应的模型slug)
    • model name: 填入你的模型名称,例如nanobanana2(或者你偏好的名称)
    • model type: 选择chat
    • Input Modality:选择text和image
    • Output Modality:选择text和image
    • Abilities:选择reasoni,不要选择tool,否则会报错

7.随后点击页面上方的Advanced Settings,点击add provider override,页面上方选择Google,以此来覆盖openai协议,配置如下:

  • 名称: 开桥(或你偏好的名称)
  • API Key: 填入你的开桥 API Key(订阅制api格式为 sk-ss-v1-xxx,Pay As You Go API Key格式为sk-ai-v1-xxx)
  • API Base URL: https://openqiao.com/api/vertex-ai/v1beta,点击save后,再次点击confirm即可返回使用
  • 注意在configure provider override这一步中,vertex ai不要打对钩

重要配置

确认将 sk-ss-v1-xxx或者sk-ai-v1-xxx 替换为你的真实开桥 API Key。你可以在 开桥控制台 中获取 API Key。

配置说明

  • API Key: 你的开桥 API Key,用于身份认证和计费
  • API Base URL: 开桥 OpenAI 兼容端点地址或者Google 兼容端点地址

步骤 3:选择模型并开始对话 ​

配置完成后,你可以在 RikkaHub 的模型列表中选择开桥提供的模型,开始对话。

常见问题 ​

连接失败怎么办? ​

  1. 确认 API Key 是否正确,可以在 开桥控制台 中查看
  2. 确认 API Base URL是否正确
  3. 检查设备的网络连接是否正常

模型列表为空? ​

请确认你使用的是 OpenAI 兼容模式接入,开桥会通过 /v1/models 端点返回所有可用模型列表。

相关链接 ​