ドキュメント
Cherry Studio
Cherry Studioのカスタムプロバイダーでは、プロトコルごとにルートアドレス(OpenAI、Anthropic、Gemini)を個別に設定します。キーとルートを入力して「モデルを同期」を押すと、カタログが自動でモデル選択欄に表示されます。
Settings → Model Services → カスタムプロバイダー:キーとAPIアドレスを貼り付け、Get Model Listをクリックすると、カタログ全体がピッカーに入力されます。
设置 → 模型服务 → 添加 → 添加自定义提供商 (Settings → Model Services → Add → Add Custom Provider)
提供商名称 / Provider name Kunavo
API 密钥 / API Key sk-kn-...
端点设置 / Endpoint settings
OpenAI https://api.kunavo.com/v1
Anthropic https://api.kunavo.com
→ 同步模型 (Sync Models), then add the models you want
→ 检测 (Test) to confirmGET /v1/modelsを呼び出します。そのため、キーとアドレスの組み合わせが正しいかをすばやく確認できます。一覧が空の場合、原因はほぼ必ずキーかアドレスであり、プロバイダーそのものではありません。https://api.kunavo.comとhttps://api.kunavo.com/v1のどちらも正しく解決されます)、続けてそのフィールド固有のルートを常に追加します。すでに/chat/completionsまたは/messagesで終わる完全なエンドポイントURLを貼り付けると、ルートが重複して追加され、リクエストは404エラーになります。sk-kn-で始まります)。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Cherry Studio設定が表示されます。手順
/app/keysでキーを作成してコピーします。キーは一度だけ表示されます。- 设置 → 模型服务(設定 → モデルサービス)を開き、添加自定义提供商(カスタムプロバイダーを追加)を選択します。
- API 密钥(APIキー)と、OpenAIのエンドポイントフィールド(
https://api.kunavo.com/v1)を入力します。 - Anthropicのフィールド(
https://api.kunavo.com)にも値を入力します。これは端点设置(エンドポイント設定)のOpenAI欄の下にあります。Cherry AgentやAnthropic Messagesプロトコルを使うモデルは、OpenAI欄ではなく、このフィールドを参照します。その他のエンドポイントタイプは更多设置(その他の設定)にあります。 - 保存後、プロバイダーのモデル一覧で同步模型(モデルを同期)を押して使用するチャットモデルを追加し、そのうち1つが最初から最後まで動作することを检测(テスト)で確認します。
- モデルは全体設定ではなく、アシスタントごとに割り当ててください。Cherry Studioではアシスタントごとにモデルを設定するため、安価な既定モデルと高性能な専門モデルを併用できます。
Cherry Studioのプロバイダー設定に関するドキュメントで2026年10月1日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。
クライアントをデバッグする前に確認すること
1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これがJSONを返すなら、同じベースURLとキーがCherry Studioで機能します。
# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."フィールドに入力するモデルID
すべてのテキストモデルにはモデルIDでアクセスできます。現在の一覧はGET /v1/models、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。
| モデル ID | Kunavo 入力 / 出力 | Cherry Studioでの位置付け |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | 日常的に使うアシスタント |
claude-opus-5 | $3.50 / $17.50 | 難しい問題用に用意するアシスタント |
claude-haiku-4-5 | $0.70 / $3.50 | 翻訳、要約など、利用頻度の高い処理 |
gpt-5-6-terra | $0.70 / $4.20 | 長文のドキュメントや、大量に貼り付けたコンテキスト |
よくある質問
Cherry StudioにカスタムAPIプロバイダーを追加するにはどうすればよいですか?
「設定」→「モデルサービス」(设置 → 模型服务)を開き、「カスタムプロバイダーを追加」(添加自定义提供商)を選択します。エンドポイントタイプごとに個別のルートアドレスを設定します。既定ではOpenAIとAnthropicが表示され、「その他の設定」(更多设置)にはOpenAI Responses、Gemini、画像エンドポイントがあります。APIキーは1つです。キーと必要なエンドポイントのルートを入力し、「モデルを同期」(同步模型)を押してカタログを取得します。使用するモデルを追加し、「テスト」(检测)でモデルが動作することを確認します。
Cherry Studioの「モデルを同期」を押しても何も表示されないのはなぜですか?
このボタンは、入力したキーを使い、OpenAIフィールドの/v1/modelsルートを呼び出します。そのため、結果が空なら、Cherry Studioではなく、そのフィールドのアドレスかキーに問題があります。各フィールドに指定するのはルートアドレスです。バージョン部分とルートはCherry Studioが追加するため、すでに/chat/completionsで終わる完全なエンドポイントURLを貼り付けていないか確認してください。同じ組み合わせをcurlで試します。JSONが返ればアプリの設定、401ならキーが原因です。
Cherry Studioのエンドポイントフィールドの末尾に#を付けるとどうなりますか?
Cherry Studioの公式ドキュメントによると、標準的な形式と異なるルートを使うエンドポイント向けに、フィールドのパスを固定します。KunavoのOpenAIとAnthropicのエンドポイントはどちらも標準形式のため、#は不要です。独自の/v1を付けても付けなくてもよいので、ルートアドレスを入力し、残りはCherry Studioに追加させてください。
AnthropicアカウントがなくてもCherry StudioでClaudeモデルを利用できますか?
はい。ゲートウェイ経由で利用できます。KunavoのアドレスはOpenAI欄ではなく、Anthropic欄に入力してください。Cherry AgentやAnthropic Messagesプロトコルを使うモデルは、そのフィールドを参照するためです。Cherry Studioはプロバイダー設定で指定されたエンドポイントにモデルIDを送信するため、ClaudeのIDはそこで解決され、Cherry Studioが保持する認証情報はそのエンドポイントのキーだけです。