導入ガイド

プロバイダー導入ガイド

ツール別の設定手順やトラブルシューティングを見る。

プロバイダー導入ガイド/Cherry Studioの設定ガイド

Cherry Studioの設定ガイド

Cherry Studioはデスクトップ向けのAIチャットツールです。組み込みプロバイダーに対応しているだけでなく、AIプロバイダー、二次開発パネル、プライベート環境にデプロイされたOpenAI互換インターフェースとの接続も可能です。設定は「設定 - モデルサービス」に集約されており、公式ドキュメントの「カスタムプロバイダー」の手順に従って設定できます。

まずはカスタムプロバイダーについて理解する

ここでの「プロバイダー」とは、Cherry Studioがモデルにアクセスするための接続先(チャンネル)として理解できます。AIプロバイダーから提供されたキー、APIアドレス、モデル名を設定することで、Cherry Studioがそのチャンネルにチャットリクエストを送信し、返答を表示します。

初めて設定する初心者の場合、まずは1つのプロバイダーのみを追加してテキストチャットが正常に動作するか確認することをおすすめします。キー、APIアドレス、モデルIDがすべて正しく動作することを確認してから、2つ目のプロバイダーや他のモデルを追加していきましょう。

新しいプロバイダーを追加するか、既存のプロバイダーを選択する

Cherry Studioを開き、左側の歯車アイコンをクリックして設定に入り、モデルサービスを選択します。リストに既に利用可能なOpenAIまたはOpenAI互換のプロバイダーがある場合は、それをクリックしてキー、APIアドレス、モデルを入力します。適切な項目がない場合は、リスト下の+ 追加をクリックして新しいプロバイダーを作成します。

新しいプロバイダーを追加する際、プロバイダー名は自分用の表示名にすぎません。プロバイダー名や「〇〇AIプロバイダー」などと入力できます。AIプロバイダーがOpenAI互換インターフェースであることを示している場合は、公式ドキュメントに従ってプロバイダータイプでOpenAIを選択してください。

設定箇所の参考 まずはプロバイダーの追加位置を確認してください。既にOpenAI互換プロバイダーがある場合は既存のものを直接選択でき、ない場合は新規追加します。
Cherry Studio公式ドキュメントでのプロバイダー追加

APIキーとAPIアドレスを入力する

設定項目入力方法
APIキープロバイダーの管理画面(トークン、Key、API Keyページ)からコピーします。アカウントのログインパスワードを入力したり、スクリーンショットのサンプルをコピーしたりしないでください。
APIアドレスいわゆるBase URL / APIリンクです。サイトのドメインそのままの場合もあれば、末尾に /v1 を追加する必要がある場合もあります。プロバイダーの管理画面やドキュメントの案内に従ってください。
有効化スイッチプロバイダーリスト右側のスイッチを有効にする必要があります。オフになっていると、情報が正しくてもチャット画面で選択できません。
チェック / 保存入力後は、まず「チェック」または「保存」をクリックします。チェックに失敗した場合は、キーの有効性、APIアドレスのコピーミス、アカウント残高、モデルの利用権限をまず確認してください。
入力項目の参考 この画像はキーとAPIアドレスの入力位置の参考用です。実際に入力する際は、ご自身が契約しているプロバイダー管理画面の情報を参照してください。
Cherry Studio公式ドキュメントでのAPIキーとAPI URL

モデルリストを取得するか、手動でモデルを追加する

まずは、Cherry Studioにプロバイダーのインターフェースからモデルリストを自動取得させてみてください。取得できない場合は、公式ドキュメントに従って手動でモデルを追加します。ここで最も重要なのはモデルID / モデル名です。管理画面のモデルリストに記載されている通りの文字列を入力し、大文字・小文字、ハイフン、ピリオドなどを変更しないでください。モデルの表示名やグループ名は画面上の表示用ですので、わかりやすい名前を自由に設定できます。

モデルリストの参考 モデルリストの自動取得を優先し、利用できない場合はプロバイダー管理画面に表示されているモデルID / モデル名を使って手動で追加してください。
Cherry Studio公式ドキュメントでのモデル追加
  1. まず「モデルリストを取得」「接続テスト」「モデルリストを更新」などのボタンをクリックし、Cherry Studioが利用可能なモデルを自動検出できるか確認します。
  2. 自動取得できない場合は、モデル設定エリアで管理または追加をクリックします。
  3. モデルID / モデル名には、プロバイダー管理画面のモデルリストに記載されている正確な識別子(例:gpt-4o、deepseek-chat)を入力します。
  4. 画面の表示名やグループ名にはわかりやすい任意の名前を使用できますが、モデルID / モデル名は勝手に変更しないでください。
  5. 保存後、チャット画面に戻り、追加したモデルを選択して短いメッセージを送信してテストします。
チャット欄にコピーして使えるテスト用プロンプト
Please reply only: Cherry Studio configuration successful
現象原因対処法
モデルリストの取得に失敗するプロバイダーがモデルリスト取得APIを開放していない管理画面に表示されているモデル名を手動で追加する
接続はできるがチャットが送信できないモデル名は表示されているが、アカウントに利用権限がない有効化されているモデルに切り替えるか、残高やモデルの権限を確認する
画像生成モデルが利用できないプロバイダーがテキストインターフェースのみに対応している通常のチャット設定で画像生成インターフェースを無理に呼び出さない