Cherry Studio API 設定 — プロバイダー、アドレス、キー

Cherry Studio で独自の API を設定するには、「設定 → モデルプロバイダー → プロバイダーを追加」に進みます。API キーを入力し、「エンドポイント設定」の OpenAI と Anthropic の各フィールドにルート URL を入力します。保存後、「モデルを同期」を押してモデルを取り込み、「チェック」で確認します。この記事は 2026 年 9 月 30 日公開の v2.1.4 を基準とし、メニュー名はすべて Cherry Studio 繁体字中国語インターフェースの原文どおりに記載しています。v2 ではプロバイダー追加画面が大幅に変更され、v1 時代の「種類で OpenAI を選ぶ」という説明は現在の画面と一致しません。

このページが対象とするのは CherryHQ/cherry-studio のデスクトップ版（AGPL-3.0、Windows、macOS、Linux 対応）です。2026 年 10 月 1 日の確認時点でリポジトリはアーカイブされておらず、最新版は v2.1.4 でした。App Store にある同名アプリは、別の開発者による無関係な製品です。また、Cherry Studio の公式ドキュメントは簡体字中国語で、インターフェースを繁体字に切り替えると「提供商／服务商」は「供應商」と表示されます。ドキュメントと照合する際は、名称の違いに注意してください。

手順に沿って設定する

Cherry Studio v2.1.4（繁体字中国語インターフェース）

設定 → 模型供應商 → 新增供應商
  （對話框標題：新增自訂供應商）

  供應商名稱                 Kunavo
  API 金鑰                   sk-kn-...
  端點設定
    OpenAI Chat Completions  https://api.kunavo.com/v1
    Anthropic Messages       https://api.kunavo.com
  更多選項
    OpenAI Responses         https://api.kunavo.com/v1   （選填）
    影像產生基礎 URL           https://api.kunavo.com/v1   （選填）
    Google Gemini            留空

→ 儲存 → 在模型清單按「同步模型」→ 加入要用的模型 → 「檢查」

設定 → モデルプロバイダーを開き、プロバイダーを追加を押します。表示されるダイアログのタイトルは「カスタムプロバイダーを追加」です。Coding Plan 系サービス、複数アカウント、またはプロジェクトごとの分離が必要な場合は、上部の「デフォルトから開始（任意）」を使い、既存のデフォルト設定から作成できます。
プロバイダー名と API キーを入力します。
エンドポイント設定には、デフォルトで OpenAI Chat Completions と Anthropic Messages の 2 つのフィールドがあります。少なくとも 1 つのテキストエンドポイントを設定してください。両方を入力すると、チャット以外の Agent や Anthropic 形式を使用する機能でもモデルを選択できます。
その他のオプションを展開すると、OpenAI Responses、Google Gemini、画像生成ベース URL、画像編集ベース URL も設定できます。使わない項目は空欄のままで構いません。
保存後、このプロバイダーが有効になっていることを確認します。公式ドキュメントによると、設定済みでも有効化されていないプロバイダーのモデルはメニューに表示されません。これは「キーが反応しない」最も一般的な原因です。
モデル一覧でモデルを同期し、使用するモデルを追加してから、チェックでテストします。

URL の入力方法：ルート URL のみを入力

v2.1.4 のソースコードによると、各フィールドにはルート URL を入力します。バージョン部分がない場合は /v1 が自動的に追加され（すでにある場合は追加されません）、その後に各フィールド固有の固定パスが続きます。各フィールドの下には「リクエストパス」が表示され、これが最終的に送信される URL です。

フィールド	Cherry Studio が接続するパス	Kunavo
OpenAI Chat Completions	`/chat/completions`	対応
Anthropic Messages	`/messages`	対応
OpenAI Responses（その他のオプション）	`/responses`	対応
画像生成ベース URL（その他のオプション）	`/images/generations`	対応
画像編集ベース URL（その他のオプション）	`/images/edits`	対応
Google Gemini（その他のオプション）	`/models/{model}:generateContent`	非対応、空欄のまま

よくある間違いは 2 つあります。1 つ目は、/chat/completions または /messages を含む完全な URL を貼り付けることで、パスが重複して 404 になります。2 つ目は末尾に # を追加することです。インターフェースには「末尾に # を追加すると API バージョンの自動付加を無効にできます」と明記されています。標準エンドポイントにこれを追加すると、/v1 が付加されなくなります。

ついでに設定して、請求額を抑える

Cherry Studio はチャット以外でもバックグラウンドでモデルを呼び出します。クイックモデルは、インターフェースの説明では「会話のタイトル付け、検索キーワードの抽出などの簡単なタスクに使用するモデル」です。また「軽量モデルを選び、推論モデルの使用は避けてください」と表示されます。ここに安価なモデルを設定すれば、会話のたびに高価なモデルを一周させずに済みます。翻訳モデルも個別に設定します。複数モデルを選んで同時に質問すると、各モデルに 1 回ずつリクエストが送られ、それぞれ 1 回分の料金が発生します。アプリの利用量統計に表示される金額は公開価格に基づく推定値であり、割引経路を利用する場合は高めに表示されます。モデル設定で単価を実際の価格に変更すれば正確になります。詳しくは英語の Cherry Studio API costを参照してください。

Kunavo の注意事項と台湾での支払い

検証範囲：上記の設定は Cherry Studio のソースコードと公式ドキュメントを整理したものです。Kunavo では Cherry Studio を自社エンドポイントに実際に接続して実行していません。現在利用できる経路を残したまま、この方法も試してください。
チャットと画像のみ：Kunavo には埋め込み（embedding）モデルがありません。ナレッジベースのベクトル検索には、別のプロバイダーまたはローカル埋め込みモデルを使用する必要があります。公式ドキュメントによると、埋め込みモデルがない場合でも、ナレッジベースは BM25 キーワード検索で動作します。
MCP ツール：「設定 → MCP サーバー」で追加したツールを呼び出すには、ツール呼び出しに対応したモデルが必要です。上記で追加した Claude と GPT のモデルはいずれも対応しています。
支払い：プリペイドチャージ、トークン単位の従量課金、月額料金なし。最低チャージ額は$10で、決済はStripeを経由します。台湾ではクレジットカード（Visa、Mastercard、American Express、JCB、UnionPay）、Apple Pay、Google Pay、Linkを利用できます。街口、LINE Payは利用可能な一覧に含まれていません。請求の説明を参照し、準備ができたらアカウントを作成してキーを生成できます。英語の設定ページはCherry Studio integration guideです。

よくある質問

Cherry Studioで独自のAPIを設定するには？

設定 → モデルプロバイダー → プロバイダーを追加に移動し、「カスタムプロバイダーを追加」ダイアログを開きます。プロバイダー名とAPIキーを入力し、エンドポイント設定のOpenAI Chat CompletionsおよびAnthropic Messagesフィールドにルートアドレスを入力して保存します。次にモデル一覧で「モデルを同期」を押してモデルを取得し、使用するモデルを追加してから、「チェック」で1つが利用可能であることを確認します。プロバイダーが有効になっていないと、モデルはメニューに表示されません。

Cherry StudioのAPIアドレスに/v1を付ける必要がありますか？

どちらでも構いません。v2.1.4のソースコードは、入力したルートアドレスの後ろにバージョン（/v1）を自動的に追加し、すでにある場合は重複させません。その後、そのフィールド固有のパス（OpenAIは/chat/completions、Anthropicは/messages）が追加されます。避けるべきなのは、/chat/completionsを含む完全なURLを貼り付けることです。パスが重複して404になります。末尾の#は「APIバージョンの自動付加を無効にする」ためのもので、標準エンドポイントには付けないでください。各フィールドの下に「リクエストパス」が表示されるので、保存前に確認すれば最終URLが分かります。

「モデルを同期」でモデルが1つも取得できない場合は？

このボタンは、入力したアドレスとキーを使ってプロバイダーのモデル一覧（/v1/models）を取得します。一覧が空の場合、多くはCherry Studioではなくアドレスまたはキーの問題です。完全なURLを貼り付けていないこと、末尾に#がないことを確認してから、同じアドレスとキーをcurlでテストしてください。JSONが返れば問題はアプリ内にあり、401が返ればキーが正しくありません。

Cherry Studioを繁体字中国語に切り替えられますか？

できます。Cherry Studioのインターフェースには繁体字中国語（zh-TW）を含む13言語が組み込まれており、設定の言語オプションで切り替えられます。繁体字インターフェースではサービスプロバイダーを「プロバイダー」と呼び、公式ドキュメントと簡体字インターフェースでは「提供商」「服務商」と表記される点に注意してください。チュートリアルと照合する際に名称が異なりますが、指しているものは同じです。

Cherry Studio は有料ですか？

デスクトップ版（コミュニティ版）は AGPL-3.0 のオープンソースソフトウェアで、無料です。料金が発生するのは、設定したプロバイダーのモデル利用料です。Cherry Studio Enterprise は別途見積もりの商用製品です。内蔵の CherryAI は無料ですが、モデルのラインナップと利用枠は公開されていません。

2026 年 10 月 1 日確認：GitHub API（CherryHQ/cherry-studio、v2.1.4）、v2.1.4 の繁体字中国語インターフェース文字列（zh-tw.json）、プロバイダー追加画面のソースコード、Cherry Studio 公式ドキュメント。Kunavo では Cherry Studio を使って自社エンドポイントを実行していません。