---
title: "Cherry Studio の接続"
description: "Cherry Studio に 1折AI をカスタムプロバイダーとして追加し、Anthropic または OpenAI の接続先、API キー、モデルを設定します。"
headingIds: {"一括インポート":"section-1","設定":"section-2","Anthropic と OpenAI エンドポイントのどちらを選ぶか":"section-3","よくある質問":"section-4"}
---

<aside className="docs-publication" data-pagefind-ignore>

ドキュメントは [1ZheAI](https://1zheai.com/en/editorial/#publisher) が管理しています。[出典と訂正](https://1zheai.com/en/editorial/)。

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

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

## 一括インポート

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

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

## 設定

<Steps>
<Step title="プロバイダーを追加する">

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

</Step>
<Step title="情報を入力する">

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

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

</Step>
<Step title="モデルを追加する">

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

</Step>
<Step title="有効にしてテストする">

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

</Step>
</Steps>

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

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

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

## よくある質問

<AccordionGroup>
<Accordion title="モデルリストの取得に失敗？">

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

</Accordion>
<Accordion title="会話で 404 エラーが出る？">

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

</Accordion>
</AccordionGroup>
