RisuAI 連携ガイド

概要

RisuAI の Custom Models スロットでは Request URL、API キー、モデル ID を貼り付けられます。注意点は Autofill Request URL というトグルです。これがオンになっていると、RisuAI が貼り付けた URL を書き換えてしまい、エラーも出さずに接続を壊してしまいます。

クイック設定

これら 3 つの値を RisuAI の Advanced Settings にある Custom Models の各フィールドにコピーしてください。

Request URL: https://api.unorouter.ai/v1/chat/completions
API キー:    YOUR_API_KEY
モデル ID:   claude-opus-4-5

末尾が `/v1/chat/completions` で終わる完全な URL を貼り付けてください。Custom Models モードではモデルドロップダウンがないため、Model ID は手動入力のテキストフィールドです。

手順ごとのセットアップ

1. 1
   Advanced Settings を開く

   RisuAI で Settings を開き、続いて Advanced Settings を開きます。

2. 2
   モデルスロットを選ぶ

   Chat Bot モデルセレクタをクリックし、モデル一覧の最下部までスクロールして Custom Models を選択します。

3. 3
   Autofill Request URL のチェックを外す

   何かを貼り付ける前に、このトグルを必ずオフにしてください。上記の重要な警告をご覧ください。

4. 4
   Request URL を貼り付ける

   末尾が `/v1/chat/completions` で終わる完全な URL を貼り付けます。

5. 5
   API キーを貼り付ける

   API Key フィールドに UnoRouter の API キーを貼り付けます。一部の RisuAI ビルドではこのフィールドが Authorization とラベル付けされています。API Key フィールドが表示されない場合は、そちらのフィールドをお使いください。

6. 6
   Model ID を貼り付ける

   UnoRouter のモデルページから正確なモデル名を入力または貼り付けます。

7. 7
   保存

   設定パネルを閉じます。RisuAI は設定をローカルストレージに書き込みます。

8. 8
   テストメッセージを送信

   任意のチャットを開き、テストメッセージを送って応答を確認します。

オートフィルトグルが重要な理由

Autofill Request URL は、名前付きプリセットプロバイダ向けにタイプミスを防ぐために追加されました。しかし Custom Models の場合、これは地雷になります。RisuAI が独自のデフォルトにカスタム URL を書き換えてしまい、当社宛ではなくなるのです。RisuAI のアップデートによりこのトグルが再びオンに戻った場合は、他の調査を始める前に手順 3 をやり直してください。

Auxiliary Model の設定

RisuAI は翻訳、要約、名前推測などのタスクに 2 つ目のモデルスロットを使用します。Auxiliary Model セレクタについても、同じ UnoRouter の URL とキーを使って手順 2 から 7 を繰り返してください。

トラブルシューティング

• 404 または「Invalid URL」。 貼り付け時に Autofill Request URL がオンになっていたため、RisuAI が URL を書き換えました。トグルをオフにして Request URL を貼り付け直してください。
• 以前は動作していたのに、今は応答がない。 RisuAI のアップデートで Autofill Request URL が密かに再有効化されることがあります。Custom Models を開いて、オフのままかを確認してください。
• 401 Unauthorized。 RisuAI のビルドによっては API Key と Authorization の両方のフィールドが表示され、バージョンによりどちらか片方のみが読み取られます。キーをもう一方のフィールドに移動して再試行してください。
• Model not found。 Model ID はモデル名と完全に一致する必要があります。再入力せず、UnoRouter のモデルページからコピー＆ペーストしてください。
• 翻訳または要約機能が壊れている。 Auxiliary Model が未設定です。Auxiliary Model スロットについてもセットアップを繰り返してください。
• ストリーミング出力がぶつ切りになる、または欠落する。 RisuAI の SSE パーサはプレーンな `data:` イベントを前提としています。プレフィックスを除去する企業プロキシは、文字化けしたストリーミングを引き起こします。可能であれば社外ネットワークで検証してください。
• ブラウザの再起動後に設定がリセットされる。 RisuAI はブラウザのローカルストレージに設定を保存しますが、一部のプライバシーモードではこれがクリアされます。Settings から設定をファイルにエクスポートしてバックアップしてください。