|

RikkaHub 接入第三方 API 中转站教程：以 API易 为例的 3 步配置指南及 /v1 与 /v1beta 渠道差异详解

作者APIYI - Stable and affordable AI API

作者注：RikkaHub 是一款支持多 LLM 的 Android 客户端，本文以 API易 为例详解接入第三方 API 中转站的完整步骤，重点解析 /v1 和 /v1beta 两种渠道类型的区别及常见踩坑

在手机上使用 AI 大模型，你不再需要在 ChatGPT、Gemini、Claude 三个 App 之间来回切换。RikkaHub 是一款原生 Android LLM 客户端，支持通过第三方 API 中转站接入所有主流模型。但不少用户在配置时踩了一个坑：同样的 API Key，在电脑端 Cherry Studio 上所有模型都能用，但在 RikkaHub 上只有 Google 模型能用，GPT 和 Claude 不行。

问题出在渠道类型上——/v1 和 /v1beta 的区别。本文以 API易为例，彻底讲清楚这个配置细节。

核心价值: 读完本文，你将学会在 RikkaHub 中正确配置 API易 中转站，理解 /v1 和 /v1beta 的区别，一个 App 调用 Claude、GPT、Gemini 全部模型。

rikkahub-android-llm-api-proxy-apiyi-configuration-guide 图示

RikkaHub 接入 API易 核心要点

要点 说明 重要性
渠道类型选择 /v1 用于全模型，/v1beta 仅用于 Gemini 最关键
Base URL https://vip.apiyi.com/v1 注意末尾路径
API Key API易 平台获取 一个 Key 用所有模型
模型选择 手动输入模型名或从列表选择 按需配置
配置方式 每种渠道类型需分别创建 Provider 最佳实践

RikkaHub 是什么

RikkaHub 是一款开源的 Android 原生 LLM 聊天客户端，基于 Kotlin + Jetpack Compose 开发，采用 Material You 设计语言。它最大的特点是支持在一个 App 中接入多个 AI 服务商，并在对话中自由切换模型。

基本信息 详情
开源地址 github.com/rikkahub/rikkahub
最新版本 v2.1.7 (2026.3.28)
支持平台 Android + Web
支持的 API OpenAI 兼容、Google Gemini 原生、Anthropic 兼容
核心功能 多模型切换、多模态输入、搜索集成、MCP 支持
安装方式 Google Play / GitHub Release / 官网下载

RikkaHub 的亮点功能包括：

  • 多模态输入: 支持图片、PDF、DOCX 文件
  • 消息分支: 在对话中探索不同回答方向
  • 搜索集成: 内置 Exa、Tavily、Brave 等搜索引擎
  • MCP 支持: 兼容 Model Context Protocol
  • Markdown 渲染: 代码高亮、LaTeX 公式、Mermaid 图表
  • 角色卡导入: 兼容 SillyTavern 角色卡

RikkaHub 配置 API易 完整教程

第 1 步: 获取 API易 API Key

首先在 API易 平台获取 API Key：

  1. 访问 API易 apiyi.com 注册账号
  2. 进入控制台，创建 API Key
  3. 复制保存 Key（格式类似 sk-xxxxxxxx）

第 2 步: 在 RikkaHub 中添加 Provider

打开 RikkaHub → 设置 → AI Provider → 添加新 Provider：

配置 OpenAI 兼容渠道（推荐，用于全部模型）:

配置项 填写内容 说明
Provider 类型 OpenAI Compatible 选择 OpenAI 兼容
Base URL https://vip.apiyi.com/v1 注意末尾是 /v1
API Key 你的 API易 Key sk-xxxxxxxx
模型名称 按需填写 如 claude-sonnet-4-20250514

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

配置完成后，在对话界面选择对应的模型即可开始使用。通过 API易 的统一接口，你可以在 RikkaHub 中调用：

  • Claude 系列: claude-sonnet-4、claude-opus-4 等
  • GPT 系列: gpt-5.4、gpt-5.4-mini 等
  • Gemini 系列: gemini-2.5-pro、gemini-2.5-flash 等
  • 开源模型: Llama 4、DeepSeek 等

🎯 快速开始: 通过 API易 apiyi.com 获取 API Key 后，只需在 RikkaHub 中添加一个 Provider，就可以在手机上自由切换所有主流 AI 模型。

rikkahub-android-llm-api-proxy-apiyi-configuration-guide 图示

/v1 和 /v1beta 渠道类型详解：最关键的配置差异

为什么同样的 Key 在 RikkaHub 上有些模型不能用

这是 RikkaHub 用户最常遇到的问题：

"为啥同样的令牌、API，电脑上 Cherry Studio 可以用，安卓 RikkaHub 上只能用谷歌的，GPT、Claude 用不了"

根本原因: RikkaHub 有两种渠道类型，选错了就会出现部分模型不可用的情况。

/v1 和 /v1beta 的核心区别

特性 /v1 (OpenAI 兼容) /v1beta (Gemini 原生)
兼容模型 Claude + GPT + Gemini + 开源模型 仅 Gemini 系列
API 格式 OpenAI Chat Completions 格式 Google Gemini 原生格式
Base URL 示例 https://vip.apiyi.com/v1 https://vip.apiyi.com/v1beta
适用场景 通用，推荐首选 需要 Gemini 特有功能时
Google 模型兼容性 良好 最佳

/v1beta 的优势和局限

/v1beta 是 Google Gemini 的原生 API 格式。当你选择 /v1beta 路径时，RikkaHub 会使用 Gemini 原生的请求格式（而非 OpenAI 兼容格式）来与服务器通信。

优势:

  • 对 Gemini 模型的兼容性最好
  • 支持 Gemini 特有的功能（如 Grounding、Safety Settings）
  • 响应格式更原生，不经过格式转换

局限:

  • 只能用于 Gemini 系列模型
  • Claude、GPT 等非 Google 模型完全不可用
  • 因为请求格式不同，发送给 Claude/GPT 的请求会直接报错

正确的配置方案

方案 A: 只用 /v1（推荐大多数用户）

如果你主要使用 Claude、GPT 和 Gemini 混合调用，只需创建一个 OpenAI 兼容的 Provider：

Provider 类型: OpenAI Compatible
Base URL: https://vip.apiyi.com/v1
API Key: sk-your-apiyi-key

这个配置可以调用 API易 上的所有模型，包括 Gemini。

方案 B: /v1 + /v1beta 双 Provider（进阶用户）

如果你希望 Gemini 模型获得最佳兼容性，可以创建两个 Provider：

Provider 类型 Base URL 用途
Provider 1 OpenAI Compatible https://vip.apiyi.com/v1 Claude / GPT / 开源模型
Provider 2 Gemini https://vip.apiyi.com/v1beta Gemini 系列（最佳兼容）

两个 Provider 使用同一个 API易 Key，在对话时根据模型自动选择对应的 Provider。

💡 避坑提示: 如果你只创建了 /v1beta 类型的 Provider，那么只有 Gemini 模型能用。这就是很多用户反馈"只能用谷歌模型"的原因。解决方案是再创建一个 /v1 类型的 Provider，或者直接用 /v1 作为唯一 Provider。

rikkahub-android-llm-api-proxy-apiyi-configuration-guide 图示

RikkaHub 常见模型配置示例

RikkaHub 热门模型配置表

以下是通过 API易 在 RikkaHub 中常用的模型配置：

模型 模型 ID 渠道类型 推荐用途
Claude Sonnet 4 claude-sonnet-4-20250514 /v1 日常对话、分析
Claude Opus 4 claude-opus-4-20250514 /v1 复杂推理
GPT-5.4 gpt-5.4 /v1 通用旗舰
GPT-5.4 Mini gpt-5.4-mini /v1 轻量高效
Gemini 2.5 Pro gemini-2.5-pro /v1 或 /v1beta 长上下文
Gemini 2.5 Flash gemini-2.5-flash /v1 或 /v1beta 快速响应
DeepSeek V3 deepseek-chat /v1 性价比推理
Llama 4 Maverick meta-llama/llama-4-maverick /v1 开源顶级

RikkaHub 高级配置技巧

自定义 HTTP 头部: RikkaHub 支持自定义请求头，如果你需要传递额外参数：

Headers:
  X-Custom-Header: your-value

QR 码导入/导出: 可以将 Provider 配置生成二维码，方便分享给朋友或在多设备间同步。

Prompt 变量: 支持在系统提示词中使用变量如 {model}（当前模型名）、{timestamp}（时间戳）。

🚀 效率提示: 通过 API易 apiyi.com 的统一接口，你只需一个 API Key 就能在 RikkaHub 中自由切换 Claude、GPT、Gemini、DeepSeek 等全部主流模型。配合 RikkaHub 的对话分支功能，可以快速对比不同模型的回答质量。

RikkaHub 与其他 Android AI 客户端对比

对比维度 RikkaHub ChatGPT App Gemini App Claude App
多模型支持 全部模型 仅 GPT 仅 Gemini 仅 Claude
自定义 API 支持 不支持 不支持 不支持
第三方中转 支持 不支持 不支持 不支持
开源 是 否 否 否
MCP 支持 是 否 否 否
搜索集成 多引擎 ChatGPT Search Google 无
价格 免费 订阅制 订阅制 订阅制

RikkaHub 最大的差异化优势是：一个 App 搞定所有 AI 模型。配合 API易 这样的中转平台，你不再需要为每个 AI 服务商单独付费和安装 App。

🎯 选型建议: 如果你只用一家 AI（如只用 ChatGPT），直接用官方 App 更方便。但如果你像大多数开发者一样需要在多个模型间切换，RikkaHub + API易 apiyi.com 是 Android 上最灵活的方案。

RikkaHub 接入 API易 常见问题排查

常见错误及解决方案

问题现象 原因 解决方案
只有 Gemini 能用，其他报错 渠道类型选了 /v1beta 改为 /v1 或新建 OpenAI 兼容 Provider
所有模型都报错 Base URL 填写错误 确认是 https://vip.apiyi.com/v1
认证失败 API Key 错误或过期 在 API易 控制台检查 Key 状态
模型不存在 模型 ID 拼写错误 参考 API易 文档确认模型 ID
响应格式异常 渠道类型与模型不匹配 Gemini 用 /v1beta，其他用 /v1

常见问题

Q1: 我应该选 /v1 还是 /v1beta?

大多数情况选 /v1。 /v1 是 OpenAI 兼容格式，支持所有模型（包括 Gemini）。/v1beta 是 Gemini 原生格式，只支持 Gemini 模型但兼容性更好。如果你主要用 Claude 和 GPT，选 /v1。如果你同时需要 Gemini 的最佳体验，可以创建两个 Provider 分别使用。通过 API易 apiyi.com 的同一个 Key 即可同时配置两种渠道。

Q2: Cherry Studio 上能用但 RikkaHub 不行怎么办?

最常见原因是渠道类型配置错误。Cherry Studio 默认使用 OpenAI 兼容格式（/v1），如果你在 RikkaHub 中选择了 Gemini 类型（/v1beta），就会导致非 Google 模型不可用。解决方案：新建一个 OpenAI Compatible 类型的 Provider，Base URL 填 https://vip.apiyi.com/v1。

Q3: RikkaHub 免费吗?

RikkaHub App 本身是免费开源的。但调用 AI 模型需要 API 费用。通过 API易 apiyi.com 平台获取 API Key，按实际用量付费，无月费和订阅费。相比同时订阅 ChatGPT Plus ($20/月)、Claude Pro ($20/月) 和 Gemini Advanced ($19.99/月)，使用 API易 + RikkaHub 的按量付费模式通常更划算。

总结

RikkaHub 接入第三方 API 中转站的核心要点：

  1. 渠道类型是关键: /v1 兼容所有模型（Claude/GPT/Gemini/开源），/v1beta 仅兼容 Gemini 但对 Google 模型兼容性更好
  2. 推荐双 Provider 方案: /v1 作为通用渠道 + /v1beta 作为 Gemini 专用渠道，同一个 API易 Key 即可
  3. 一个 App 搞定所有: RikkaHub + API易 apiyi.com，在 Android 上实现 Claude、GPT、Gemini 等全模型自由切换

不再需要在三四个 AI App 之间来回切换。推荐通过 API易 apiyi.com 获取 API Key，一个 Key 覆盖所有主流模型，配合 RikkaHub 在手机上打造你的 AI 全能助手。

📚 参考资料

  1. RikkaHub GitHub 仓库: 开源代码和最新版本下载

    • 链接: github.com/rikkahub/rikkahub
    • 说明: 包含完整源码、Release 下载和功能说明

  2. RikkaHub 官方文档: Provider 配置和使用指南

    • 链接: docs.rikka-ai.com
    • 说明: 包含各类 Provider 的详细配置方法

  3. API易 文档中心: API Key 获取和模型列表

    • 链接: docs.apiyi.com
    • 说明: 包含所有支持模型的 ID、定价和调用示例

作者: APIYI 技术团队
技术交流: 欢迎在评论区分享你的 RikkaHub 配置经验，更多 AI 模型接入资料可访问 API易 docs.apiyi.com 文档中心

Try AI Large Model https://api.apiyi.com for free
Stable and reliable AI LM API aggregation service, Get 300 Millions Tokens for Free~

类似文章