RikkaHub 中継API導入ガイド：Android AIチャットクライアント設定

发布时间2026年9月16日 04:44
语言ja

RikkaHub（Android用オープンソースAIチャットクライアント）導入ガイド：sk-キーの作成、モデルグループに応じたプロバイダータイプの選択、Base URL設定により、Gemini / Claude / GPTモデルを簡単に呼び出せます。

一、RikkaHubとは

RikkaHubは、Anthropic（Claude）、OpenAI（GPT）、Google（Gemini）など、複数のモデルチャネルに接続可能なオープンソースのAndroid向けAIチャットクライアントです。Provider（プロバイダー）を中継ゲートウェイに向け、sk-キーを入力するだけで、プラットフォームのクレジットを使用して各モデルをトークン課金形式で利用できます。

二、事前準備

極智APIコントロールパネルにログインし、「APIキー」でsk-xxxxxxキーを作成します（一度しか表示されないため、必ず保存してください）。
使用するモデルslug（例：gemini-3.7-flash、claude-sonnet-5、gpt-5.5）を確認します。コントロールパネルの「トークン」ページ右上にある「モデルID」から確認可能です。
ゲートウェイアドレスを確認します：https://www.relay-api.com

三、RikkaHubでの設定

RikkaHubを開き、「設定」→「プロバイダー」→ 右上の「+」から新規追加し、使用するモデルに合わせてプロバイダータイプを選択します：

① Geminiを呼び出す（Googleタイプ、推奨）

プロバイダータイプ : 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タイプ）

プロバイダータイプ : 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互換タイプ）

プロバイダータイプ : OpenAI 互換 / OpenAI Compatible
Base URL      : https://www.relay-api.com/v1
API Key       : sk-あなたのキー
モデルID      : gpt-5.5

四、インターフェースアドレス対照表

モデルグループ	プロバイダータイプ	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

五、重要：モデルはグループ別に分離されており、グループをまたいだ呼び出しはできません

本サイトの3種類のプロトコルはそれぞれ独立したネイティブ入口であり、モデルはグループごとに分離されています：

Geminiグループのモデル（gemini-3.7-flashなど）は、必ず「Google / Gemini」タイプ + /v1beta を経由する必要があります。
Geminiのモデル名をAnthropicタイプに入力すると、400 未启用或不存在 Claude 模型: gemini-xxx（Claudeモデルが有効でないか存在しません）が返されます。
Geminiのモデル名をOpenAIタイプに入力すると、400 未启用或不存在 OpenAI 模型: gemini-xxx（OpenAIモデルが有効でないか存在しません）が返されます。

そのため、「モデルID」と「プロバイダータイプ」を一致させる必要があります：どのグループのモデルを使用するかによって、対応するプロバイダータイプを選択してください。

六、トラブルシューティング

現象	原因と対応
`404`エラー（ページ/HTML）が返る	Base URLのバージョン末尾が抜けています（例：Geminiで `/v1beta` が不足）。存在しないパスにリクエストが送られているため、`/v1beta` または `/v1` を追記してください。
パスに `/v1beta/v1beta/` や `/v1/v1/` が表示される	Base URLでバージョン番号が重複しています。Base URL内には1回だけ記述してください。
`400 未启用或不存在 Claude/OpenAI 模型: gemini-xxx`	モデルグループとプロバイダータイプが一致していません。Claude/OpenAIタイプにGeminiモデルが入力されています。「Google / Gemini」タイプに変更してください。
`401 / 403`	キーが無効、未有効化、残高不足、またはそのトークンが該当ルート/モデルへのアクセス権限を持っていない可能性があります。キーと口座残高を確認してください。
`400 Request contains an invalid argument`	アップストリームでの個別のパラメータチェック（思考レベルの大文字小文字、ツール呼び出しなど）によるものです。一時的なアップストリームの変動の可能性があるため、再試行してください。
モデルリストの取得失敗	一部のクライアントは中継先から返されるモデルリストの解析が厳格な場合があります。「手動でモデルIDを入力」する方法を試してください。

七、セキュリティに関するアドバイス

キーを公開リポジトリやスクリーンショットに含めないでください。環境変数やローカルの安全な場所に保存することを推奨します。
各デバイスやツールごとに個別のキーを作成し、使用量の統計や必要に応じた停止を容易にできるようにしてください。