Cherry StudioでAPIを設定する場所はSettings → Model Provider → Add Providerです。API Keyを入力し、Endpoint settingsのOpenAI・Anthropic欄にそれぞれルートアドレスを入力して保存し、「Sync models」でモデルを取得して「Check」で確認すれば完了です。まず知っておくべき点として、Cherry Studioには韓国語UIがないため、メニューは英語の原文をそのまま記載しています。 このページは2026年9月30日に公開されたv2.1.4を基準にしています。v2ではプロバイダー追加画面が大きく変更されたため、v1時代の「Type: OpenAI」方式の説明は現在の画面と一致しません。
対象はCherryHQ/cherry-studioのデスクトップ版（AGPL-3.0、Windows・macOS・Linux）です。2026年10月1日時点でリポジトリはアーカイブされておらず、最新バージョンはv2.1.4です。App Storeにある同名アプリは別の開発者による無関係なアプリです。組み込みUI言語は13言語で韓国語はないため（v2.1.4のUI翻訳ファイルに基づく）、英語UIで操作することを前提とします。
手順ごとの設定
Settings → Model Provider → Add Provider
(대화상자 제목: Add Custom Provider)
Provider Name Kunavo
API Key sk-kn-...
Endpoint settings
OpenAI https://api.kunavo.com/v1
Anthropic https://api.kunavo.com
More options
OpenAI Responses https://api.kunavo.com/v1 (선택)
Image Generation Base URL https://api.kunavo.com/v1 (선택)
Gemini 비워 둠
→ Save → 모델 목록에서 "Sync models" → 쓸 모델 추가 → "Check"- Settings → Model ProviderでAdd Providerをクリックします。開くダイアログのタイトルは「Add Custom Provider」です。Coding Plan系サービスや複数アカウント、プロジェクト分離が必要な場合は、上部の「Start from a preset (optional)」から既存のプリセットを使って開始することもできます。
- Provider NameとAPI Keyを入力します。
- Endpoint settingsには最初からOpenAIとAnthropicの2つの欄があります。テキストエンドポイントは少なくとも1つ必要です（空欄にすると「Configure at least one text endpoint」エラー）。両方を入力すると、チャットだけでなくAgentやAnthropic形式を使う機能でもモデルを選択できます。
- More optionsを展開すると、OpenAI Responses、Gemini、Image Generation Base URL、Image Edit Base URLの欄があります。使わない欄は空欄にしてください。
- 保存後、そのプロバイダーが有効化（Enable）されていることを確認します。公式ドキュメントによると、設定だけして有効化していないプロバイダーはモデル選択リストに表示されません。「キーが機能しない」場合の最も一般的な原因です。
- モデル一覧でSync modelsを使ってモデルを取得し、使用するモデルを追加してから、Checkで1つを確認します。
アドレスの書き方：ルートアドレスのみ
v2.1.4のソースによると、各欄にはルートアドレスを入力します。バージョン部分がなければ/v1を自動的に追加し（すでにあれば追加しません）、その後に欄ごとの固定パスを追加します。各欄の下に「Request path」として最終URLが表示されるため、保存前に確認してください。
| 欄 | Cherry Studioが追加するパス | Kunavo |
|---|---|---|
| OpenAI | /chat/completions | 対応 |
| Anthropic | /messages | 対応 |
| OpenAI Responses（More options） | /responses | 対応 |
| Image Generation Base URL（More options） | /images/generations | 対応 |
| Image Edit Base URL（More options） | /images/edits | 対応 |
| Gemini（More options） | /models/{model}:generateContent | 未対応、空欄のまま |
よくある間違いは2つあります。/chat/completionsや/messagesまで含む完全なURLを貼り付けると、パスが二重に追加されて404になります。また、末尾の#は画面の説明どおり「Add # at the end to disable the automatically appended API version」、つまりバージョン自動追加を無効にする記号です。標準エンドポイントに付けると/v1が抜けます。アドレスとキー自体を確認するには、以下のコマンドが最も速い方法です。
curl https://api.kunavo.com/v1/models \
-H "Authorization: Bearer $KUNAVO_API_KEY"料金を抑える基本モデル設定
Cherry Studioはチャット以外でもバックグラウンドでモデルを呼び出します。Quick Modelは画面の説明どおり、「会話名の付与や検索キーワードの抽出などの簡単な作業」に使われ、案内にも「軽量モデルを選び、推論モデルは避ける」とあります。ここに安価なモデルを設定しておけば、会話のたびに高価なモデルが動くことはありません。Translate Modelも別途設定します。複数のモデルを選んで一度に質問すると、モデル数と同じ数のリクエストが個別に送信され、個別に課金されます。アプリの利用量統計の金額は公開価格に換算した推定値なので、割引経路では実際より高く表示されます。モデル設定で単価を実際の料金に変更すると正しくなります。詳しくは英語ページCherry Studio API costをご覧ください。
Kunavo利用時の注意点と支払い
- 検証範囲：この設定はCherry Studioのソースと公式ドキュメントを確認して作成したもので、KunavoがCherry Studioを自社エンドポイントに実際に接続して動作確認したものではありません。現在の経路を変えずに試してください。
- チャットと画像のみ：Kunavoには埋め込みモデルがないため、ナレッジベースのベクトル検索には別のプロバイダーまたはローカル埋め込みモデルが必要です。公式ドキュメントでは、埋め込みモデルがなくてもナレッジベースはBM25キーワード検索で動作すると説明されています。
- MCPツール：Settings → MCP Serversで追加したツールは、ツール呼び出しに対応するモデルで使用する必要があります。上で追加したClaude・GPTモデルは対応しています。
- 決済：月額料金のない前払いチャージで、トークン単位で残高から差し引きます。最低チャージ額は$10で、Stripe Checkoutではカード（Visa、Mastercard、American Express、JCB、UnionPay）、Apple Pay、Google Pay、Linkを利用できます。チェックアウトが韓国ウォンで表示される場合は、Kakao Pay、Naver Pay、PAYCO、Samsung Pay、および海外決済がブロックされた韓国国内カードも選択肢として表示されます（2026年10月3日追加、これらの方法で決済された実績はまだありません）。金額はドルで設定され、ウォン表示はStripeが換算します。その為替レートには支払者が負担する2–4%の換算手数料が含まれます。Toss Payは利用できません。決済ガイドを確認し、アカウントを作成してキーを発行してください。英語版の設定ページはCherry Studio integration guideです。
よくある質問
Cherry StudioでAPIを設定する方法は？
Settings → Model Provider → Add Providerをクリックすると、「Add Custom Provider」ダイアログが開きます。Provider NameとAPI Keyを入力し、Endpoint settingsのOpenAIとAnthropic欄にルートアドレスを入力して保存します。その後、モデル一覧で「Sync models」を使ってモデルを取得し、使用するモデルを追加して、「Check」で1つを確認します。プロバイダーが有効化（Enable）されていないと、モデルは選択リストに表示されません。
Cherry Studioを韓国語で使えますか？
UIは韓国語に対応していません。v2.1.4のUI言語は英語、中国語（簡体字・繁体字）、日本語、ドイツ語、フランス語、スペイン語、ポルトガル語、ロシア語、ギリシャ語、ルーマニア語、トルコ語、ベトナム語の13言語です。メニューは英語で記載されることが多いため、このページでは英語のメニュー名をそのまま記載しています。モデルとの会話自体は韓国語で行えます。
APIアドレスに/v1を付ける必要がありますか？
付けても付けなくても構いません。v2.1.4のソースは、入力したルートアドレスにバージョン（/v1）がなければ自動的に追加し、あればそのままにしてから、欄ごとのパス（OpenAIは/chat/completions、Anthropicは/messages）を追加します。避けるべきなのは/chat/completionsまで含む完全なURLを貼り付けることです。パスが二重に追加され、404になります。末尾に付ける#はバージョンの自動追加を無効にする記号なので、標準エンドポイントには使わないでください。欄の下にある「Request path」で最終URLを確認できます。
Sync modelsを押してもモデルが表示されない場合は？
このボタンは入力したアドレスとキーを使ってプロバイダーのモデル一覧（/v1/models）を要求します。空の場合は、たいていアドレスかキーの問題です。完全なURLを貼り付けていないか、末尾に#がないかを確認し、同じアドレスとキーでcurlを実行してみてください。JSONが返ればアプリ側の問題、401ならキーの問題です。
Cherry Studioは無料ですか？
デスクトップのコミュニティ版はAGPL-3.0のオープンソースで、無料です。費用がかかるのは、設定したプロバイダーのモデル利用料です。Cherry Studio Enterpriseは見積もり制の別製品で、組み込みのCherryAIは無料ですが、モデル構成と上限は公開されていません。
2026年10月1日確認：GitHub API（CherryHQ/cherry-studio、v2.1.4）、v2.1.4のUI翻訳ファイル一覧と英語UI文字列（en-us.json）、プロバイダー追加画面のソース、Cherry Studio公式ドキュメント。KunavoはCherry Studioを自社エンドポイントで実行していません。