|

RikkaHub 接入第三方 API 中轉站教程：以 API易 爲例的 3 步配置指南及 /v1 與 /v1beta 渠道差異詳解

ByAPIYI - 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-zh-hant 图示

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-zh-hant 图示

/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-zh-hant 图示

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~

Similar Posts