Cherry Studio の接続

ドキュメントは 1ZheAI が管理しています。出典と訂正。

エラーを見つけましたか？ページのアドレスと説明を添えてサポートに連絡してください。API キーやアカウント情報は送信しないでください。

Cherry Studio はデスクトップ用の AI チャットクライアントで、1折AI をカスタムプロバイダーとして追加できます。

一括インポート

コンソールの API API キー → 使用工具 → Cherry Studio で Anthropic または OpenAI プロトコルを選択し、Open Cherry Studio をクリックします。アプリ内でインポートを確認した後、モデルを取得し、プロバイダーを有効化してテストします。同名の設定が既にある場合は上書きの警告を確認してください。インポートリンクには完全なキーが含まれているため、転送しないでください。

ブラウザはアプリがインストールされているかどうかを確認できません。起動しない場合は、まずクライアントをインストールして一度起動するか、以下の手動手順を使用してください。プロトコル形式は公式実装と照合済みですが、実際の推論は実際のバージョンとモデルで検証する必要があります。

設定

1. プロバイダーを追加する

   設定（歯車アイコン）→ モデルサービス → リスト下部の + プロバイダーを追加。

2. 情報を入力する

   項目	入力内容
   提供商名称	1折AI
   API API キー	sk-你的Key
   端点	Anthropic（推奨）または OpenAI を選択
   API 接続先	https://1zheai.com

   API 接続先にはルートアドレスのみを入力してください。Cherry Studio は選択したプロトコルに応じて自動的に /v1/... を補完します。/v1/messages、/v1/chat/completions のような完全なパスを貼り付けず、末尾に #（# で終わるとパスが自動補完されなくなります）も追加しないでください。

3. モデルを追加する

   获取模型列表 をクリックし、返されたリストから使用するモデルを追加するか、+ をクリックしてモデル ID を手動入力してください（例：claude-sonnet-5-5）。リストに追加したモデルのみがチャットのモデル選択に表示されます。

4. 有効にしてテストする

   プロバイダーページ右上の有効化スイッチをオンにし、チャット画面に戻って 1折AI 配下のモデルでメッセージを送信します。

Anthropic と OpenAI エンドポイントのどちらを選ぶか

エンドポイント	適している用途
Anthropic	extended thinking などの Claude ネイティブ機能を使いたい場合。Agent のプロトコル制限は現在のバージョンに従ってください
OpenAI	OpenAI 形式に慣れている場合、または他の OpenAI 互換サービスと統一管理したい場合

どちらのエンドポイントも同じ API API キー（API key）と同じモデル ID セットを使用します。

よくある質問

モデルリストの取得に失敗？

まず API API キーに余分な空白がないか確認し、次に API 接続先が https://1zheai.com で余分なパスが書かれていないか確認してください。取得できなくても使用には影響せず、モデル ID を手動入力しても動作します。

会話で 404 エラーが出る？

API 接続先に完全なパスが書かれているか、末尾に # が追加されています。ルートアドレス https://1zheai.com に戻してください。