Cherry Studio
Cherry Studio は OpenAI compatible Provider と /v1 Base URL で接続できます。
設定前の確認
- このページはプレースホルダーだけを使います。実際の Key は PopGo API keys から、モデルは models and pricing からコピーします。
- ワンクリック設定は、ソフトウェアがインストール済みでプロトコルハンドラ登録済みの場合に使います。ブラウザが外部アプリを開く確認を出したら許可します。
- 手動設定では、まず最小 Provider を保存します。最初のリクエスト成功後にストリーミング、ツール、多モデルルーティングを有効にします。
公式情報と検証
Cherry Studio 1.9.12 は、2026-07-13 に公式情報と照合しました。 公式情報. Cherry Studio のカスタム Provider 設定を検証しました。
ワンクリック設定
PopGo API キーページにログインし、対象 Key 行の操作メニューを開きます。公開ドキュメントは Key を含むリンクを生成、表示しません。 Chat サブメニューを開き、Cherry Studio を選択します。 取り込み後、OpenAI compatible と現在利用可能なモデルを確認します。
手動設定
Provider 設定で OpenAI compatible を選び、下表を入力します。
| 項目 | 値 |
|---|---|
| Provider 種別 | OpenAI compatible |
| Base URL | https://api.popgo.site/v1 |
| API Key | YOUR_API_KEY |
| Model | YOUR_MODEL |
文字による設定手順
- Cherry Studio を現在のバージョンに更新またはインストールし、「設定 → モデルサービス」を開きます。
- カスタム Provider を作成し、
OpenAI compatibleを選択します。組み込みの公式 Provider は変更しません。 - Base URL に
https://api.popgo.site/v1、API Key にYOUR_API_KEY、Model にYOUR_MODELを入力します。 - 保存して新しい会話を作り、最初に短いメッセージを送ります。成功後に画像、動画、ツール、長いコンテキストを有効にします。
- プロトコルやモデル系列が違う場合は Provider を分け、アドレスを混在させないでください。
よくある設定の症状
- モデル一覧が空でも接続失敗とは限りません。第三者モデルを自動取得しない場合は
YOUR_MODELを手入力します。 - 保存後も既定サービスを使う場合は、新しい Provider と会話を選び、クライアントを再起動します。
- 古いバージョンで新しい機能が表示されない場合は更新し、現在の UI の項目に従います。
成功の確認
モデルテストまたは新規会話で短文を送り、正常な内容が返ることを確認します。
よくあるエラーと復旧
- 接続テストに失敗したら、Base URL 末尾の
/v1が重複していないか確認します。 - 401 では
YOUR_API_KEYを再入力し、前後の空白を除きます。 - 404 では Base URL の階層と、クライアントによる
/v1の二重追加を確認します。