Cherry Studio

Cherry Studio はカスタムプロバイダー経由で HiAPI に接続できます。1 つのプロバイダーに OpenAI、Anthropic、OpenAI Responses の 3 つのエンドポイントを同時に持たせられ、それぞれが異なるプロトコルに対応します。モデルが対応するプロトコルに合ったエンドポイントを選んでください。以下の手順は claude-opus-5-5、gpt-6-astra、deepseek-v4.1-flash を例にしています。本チュートリアルは Cherry Studio 2.1.7 で検証済みです。

1. HiAPI の API キーを用意する

API キーの取得 の手順でキーを用意し、キーの横にあるコピーアイコンをクリックして、完全な HiAPI API キー をコピーしておき、以下の Cherry Studio で入力します。

2. プロトコルを選ぶ

このページの例のモデルは、上表の組み合わせでいずれも検証済みです。別のモデルを使う場合は、まず表からエンドポイントを選び、メッセージを送って試してください。400 does not support this endpoint が返ってきたら、別のエンドポイントに切り替えます。

3. プロバイダーを追加する

3.1 入口

Settings → Model Providers → Add Provider（设置 → 模型服务 → 添加提供商）をクリックします。

3.2 3 つのエンドポイントすべてに同じアドレスを入力する

3 つのエンドポイントすべてに、/v1 を付けずに https://api.hiapi.ai を入力します。パスは Cherry Studio が自分で付加します。この点は他のツールとは異なります。

3.3 実際のリクエストパスを確認する

一致しない場合は次のように直します。/v1/v1/... になっている場合は、その項目を https://api.hiapi.ai に変更します。/v1 が足りない場合は、https://api.hiapi.ai/v1 に変更します。

4. モデルを追加してプロトコルを設定する

モデル名を追加したら、そのモデルの鉛筆アイコンをクリックして Edit Model（编辑模型）を開きます。モデルのプロトコルに合った Chat protocol（对话协议）を選び、Max output tokens（最大输出 Token）を設定します。

4.1 プロトコルの例

以下の 3 つのモデルで、まずモデル名を追加します。

claude-opus-5-5
gpt-6-astra
deepseek-v4.1-flash

次にモデルの鉛筆アイコンをクリックして Edit Model（编辑模型）を開き、チャットプロトコルを次のように選びます。

5. 動作確認

設定を変更したら、新しいチャットを開始してテストしてください。既存のチャットにはパラメータがキャッシュされています。

5.1 チャット

新しいチャットを開始し、設定した各モデルで「こんにちは。自己紹介を一文でお願いします。」と送ります。正常に返答があれば接続できています。

5.2 ツール呼び出し

MCP 設定ガイド の Cherry Studio の節に従って MCP を設定し（組み込みサーバー、またはマーケットプレイスからインストールしたもの）、MCP がアクセスを許可されているフォルダに tool-call-test.txt を作成し、hello hiapi の 1 行を書いて保存します。次に「ファイル読み取りツールを1回だけ使ってください。tool-call-test.txt の全内容を読み取り、そのままの形で返してください。ファイルを変更しないでください。他のファイルも読まないでください。ファイル名から内容を推測しないでください。」と送ります。ツール呼び出しが表示され、hello hiapi が返ってくれば成功です。

6. トラブルシューティング

ここには Cherry Studio 固有の問題だけを記載しています。401、404、429 などの一般的なエラーは よくあるエラー を参照してください。