Cherry Studio 設定
Cherry Studio は、クロスプラットフォームの AI デスクトップクライアント（Windows、macOS、Linux 対応）で、マルチモデル会話、ナレッジベース、ワークフローをサポートする、最も機能豊富なオープンソース AI クライアントの一つです。
OfoxAI をプロバイダーとして設定することで、Cherry Studio で GPT、Claude、Gemini、DeepSeek など 100 以上のモデルを 1 つの API Key で利用できます。
プロトコルの説明
Cherry Studio は以下の 4 つのプロトコルで OfoxAI に接続できます：
OpenAI Chat — /v1/chat/completions ベース、GPT シリーズモデル用（openai/gpt-4.1、openai/gpt-5.3-chat など）。
OpenAI Response — /v1/responses ベース、GPT シリーズモデル用（openai/gpt-4.1、openai/gpt-5.4-mini など）。
Claude — /anthropic/v1/messages ベース、Claude シリーズモデル用（anthropic/claude-sonnet-4.6、anthropic/claude-opus-4.6 など）。
Gemini — /gemini/v1beta/models ベース、Gemini シリーズモデル用（google/gemini-3.1-pro-preview、google/gemini-3.1-flash-lite-preview など）。
前提条件
設定手順
ステップ 1：設定を開く
Cherry Studio を起動し、左下の 設定 アイコンをクリックします。
ステップ 2：モデルプロバイダーを追加
左側の モデルサービス に移動し、下までスクロールして + 追加 をクリックします。ダイアログでプロバイダー名を入力し、対応するプロバイダータイプを選択します。
OpenAI Chat
プロバイダータイプで OpenAI を選択し、OK をクリックします。
OpenAI Response
プロバイダータイプで OpenAI を選択し（後で設定ページで Response モードを有効にします）、OK をクリックします。
Claude
プロバイダータイプで Anthropic を選択し、OK をクリックします。
Gemini
プロバイダータイプで Gemini を選択し、OK をクリックします。
ステップ 3：API 設定を入力
プロバイダーの設定ページで API キーと API アドレスを入力します。
OpenAI Chat
| 項目 | 値 |
|---|---|
| API キー | あなたの OfoxAI API Key |
| API アドレス | https://api.ofox.ai/v1 |
OpenAI Response
| 項目 | 値 |
|---|---|
| API キー | あなたの OfoxAI API Key |
| API アドレス | https://api.ofox.ai/v1 |
Claude
| 項目 | 値 |
|---|---|
| API キー | あなたの OfoxAI API Key |
| API アドレス | https://api.ofox.ai/anthropic |
Gemini
| 項目 | 値 |
|---|---|
| API キー | あなたの OfoxAI API Key |
| API アドレス | https://api.ofox.ai/gemini |
ページ右上のスイッチが オン（ON） になっていることを確認してください。オフの場合、プロバイダーはモデルセレクターに表示されません。
ステップ 4：モデルを追加
モデルセクションの 管理 ボタンをクリックしてモデルリストを自動取得し、モデルの横にある + をクリックして有効リストに追加します。
OpenAI Chat
OpenAI Response
Claude
Gemini
ステップ 5：設定を確認
テスト ボタンをクリックし、任意のモデルを選択してテストします。テスト成功と表示されれば設定完了です。
OpenAI Chat
OpenAI Response
Claude
Gemini
使用開始
メインインターフェースに戻り、チャット上部のモデルセレクターをクリックして、対応するプロバイダーグループからモデルを選択してチャットを開始します。
画像生成
Cherry Studio は Gemini プロトコルを通じて OfoxAI の画像生成モデルを呼び出し、会話内で直接画像を生成できます。
ステップ 1：Gemini プロバイダーを追加
モデルサービス に移動し、下部の + 追加 をクリックします。
ダイアログでプロバイダータイプとして Gemini を選択し、OK をクリックします。
ステップ 2：設定と画像生成モデルの取得
API アドレスに https://api.ofox.ai/gemini を入力し、モデルリストを取得 をクリックして、以下の画像生成モデルを追加します：
Google: Nano Banana Pro (Gemini 3 Pro Image Preview)Google: Nano Banana (Gemini 2.5 Flash Image)Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview)
ステップ 3：アシスタントを編集し、画像パラメータを設定
メインインターフェースでアシスタントを右クリックし、アシスタントを編集 を選択します。
編集ページで：
- デフォルトモデル を先ほど追加した画像生成モデルに設定
- + パラメータを追加 をクリックし、以下の 2 つのカスタムパラメータを追加：
| パラメータ | タイプ | 値 |
|---|---|---|
responseModalities | JSON | ["IMAGE"] |
imageConfig | JSON | {"aspectRatio": "1:1", "imageSize": "1K"} |
imageConfig でアスペクト比と解像度を調整できます。2K 画像が必要な場合は imageSize を "2K" に変更してください。
ステップ 4：画像生成を開始
設定を保存後、チャットで画像の説明を入力すると画像が生成されます。
よくある質問
Q:「管理」をクリックした後、モデルリストが空です
API アドレスが正しいか（末尾にスラッシュなし）、API キーが完全にコピーされているか（余分なスペースなし）を確認してください。
Q: 確認時に接続失敗と表示される
- API Key が OfoxAI コンソール から完全にコピーされているか確認
- API アドレスが正しいか確認
- ネットワーク接続が正常か確認
Q: プロバイダーがモデルセレクターに表示されない
設定ページ右上のスイッチが有効になっているか確認してください。