ガイド一覧 / チャットクライアント

Cherry Studio で XHuoAPI を使う

Cherry Studio は公式にゲートウェイ型プロバイダーを新たに内蔵しない方針で、「カスタムプロバイダー」として追加します。設定方法は内蔵の OpenAI と同じです。

はじめる前に

コンソールで登録し、API トークンを作成します。登録に必要なのはメールアドレスだけで、電話番号は不要です。
トークン作成時にティアを選びます。新規アカウントの既定は Standard です。ティアは価格と安定性、そして利用できるモデルを決めます。詳細は料金ページを参照してください。

まず確認

ツールを設定する前に、curl でキーとモデルが使えることを確認してください。「設定したのに反応がない」の半分はこれで切り分けられます。

curl https://api.xhuoapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'

設定手順

設定 → モデルサービスで下部の + 追加をクリック。名前は任意、プロバイダータイプは OpenAI を選びます。

API キーと API アドレスを入力します。Cherry Studio が /v1/chat/completions を自動付加するため、アドレスはドメインだけです。

API 地址 / API address:  https://api.xhuoapi.ai
API 密钥 / API key:      sk-...

「モデル一覧を取得」をクリックし、表示されたモデル管理で使いたいモデルの右側の + を押して追加します。追加したモデルだけがアプリ内の選択肢に表示されます。最後に右上の有効化スイッチをオンにします。

注意点

アドレスの末尾が # の場合、Cherry Studio はパスを自動付加せず入力どおりのアドレスを使います。上流のパスが標準の /v1/chat/completions でない場合以外は不要です。

モデル名の下に上流が返す実際の ID が表示されます。名前が似たバージョンは統合されないので、追加前に ID を確認してください。

Qwen 系列と画像・動画モデルは Standard と Official ティアでのみ利用できます。Saver や Spot ティアのトークンでは「モデルが利用できません」が返ります。

よく使われるモデル

この種のツールでよく選ばれるモデルです。モデル名をクリックするとティア別の価格を確認できます。全一覧は料金ページにあります。

deepseek-v3.2 qwen3.8-max gemini-3.7-flash claude-sonnet-5 gpt-5.4-mini

手順は各ツールの現行の公式ドキュメントに基づいています。アップデートで UI が変わることがあります。相違があればお知らせください。