> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Cherry Studio で BeatAPI を使う

> Cherry Studio に BeatAPI を OpenAI タイプとして登録し、1 つのデスクトップアプリでアカウントの全モデルを利用します。

# Cherry Studio で BeatAPI を使う

Cherry Studio は複数の接続先を並行して利用できるデスクトップチャットクライアントです。BeatAPI を OpenAI タイプとして登録すると、アカウントのすべてのテキストモデルがモデル選択画面に表示されます。

## 前提条件

1. **Cherry Studio がインストールされていること。** [公式サイト](https://cherry-ai.com/)から入手します。
2. **BeatAPI API キー。** [ダッシュボード → API キー](https://beatapi.io/dashboard/apikeys)で作成します。

## ステップ 1：接続先の設定を開く

右上の設定アイコン、または `Ctrl+,`（macOS は `Cmd+,`）を押し、左メニューで **Model Service** を選択します。

## ステップ 2：BeatAPI を追加する

Model Service ページの下部で **+ Add** を押し、次を入力します。

| 項目            | 値         |
| ------------- | --------- |
| Provider Name | `BeatAPI` |
| Provider Type | `OpenAI`  |

**Confirm** を押し、右側の設定パネルに次を入力します。

| 項目      | 値                        |
| ------- | ------------------------ |
| API Key | BeatAPI API キー           |
| API URL | `https://api.beatapi.io` |

> **Note**
>
> `/v1` や末尾のパスを付けず、`https://api.beatapi.io` を入力してください。Cherry Studio 自身が `/v1/chat/completions` を付加します。`/v1` を付けると `/v1/v1/chat/completions` となり、毎回 `404` になります。

右上の BeatAPI の切り替えが**オン**（緑）になっていることを確認し、モデルを追加する前に **Test** で接続を確認します。

## ステップ 3：モデルを追加する

**Models** セクションの **Manage** でモデル選択画面を開きます。使いたい ID を検索し、**+** で追加します。

| モデル ID                 | 用途                                    |
| ---------------------- | ------------------------------------- |
| `claude-fable-5-1`     | 最新世代の Claude                          |
| `gpt-6-astra`          | 最新世代の OpenAI。入力トークンが 272K を超えると単価が上がる |
| `gpt-5.6-terra`        | バランスのよい日常チャット                         |
| `gemini-3.7-flash`     | 高速、低価格、マルチモーダル                        |
| `deepseek-v4-pro-0813` | 低価格で高い推論性能                            |
| `glm-5.3-flash`        | 大量のチャット向けの最も低価格なモデル                   |
| `kimi-k3`              | 長いコンテキストの処理                           |
| `qwen3.8-max`          | 中国語の処理                                |

全モデルは [Text API](/text-api) と[料金ページ](https://beatapi.io/pricing)に掲載しています。必要なだけ追加でき、チャット上部のドロップダウンで切り替えられます。

## ステップ 4：チャットする

メイン画面に戻り、**+** で新しいチャットを開始します。上部のモデル選択で **BeatAPI** のモデルを選びます。

## よくある質問

### Cherry Studio が接続できません

1. API URL は `/v1` なしの `https://api.beatapi.io` を指定します。
2. [ダッシュボード → API キー](https://beatapi.io/dashboard/apikeys)でキーが有効か確認します。
3. 接続先の切り替えをオンにします。

### モデル一覧が空、または更新されません

モデル管理画面で ID を手動で追加してください。ID は[料金ページ](https://beatapi.io/pricing)に掲載しており、大文字と小文字を区別します。

### 会話中にエラーが発生します

| ステータス         | 意味                                                                | 対処                                                            |
| ------------- | ----------------------------------------------------------------- | ------------------------------------------------------------- |
| `401`         | `missing_api_key` または `invalid_api_key`。キーが未指定、不正、期限切れ、無効、または上限到達 | ダッシュボードからキーをコピーし直す                                            |
| `402`         | `insufficient_credits`。残高が 0、または料金に不足                             | チャージする                                                        |
| `404`         | モデル ID または API URL が不正                                            | 上記の説明と両方を照合する                                                 |
| `429`         | リクエスト数の上限超過                                                       | 待つ。上限はチャージ累計額に応じて増える                                          |
| `500` / `503` | BeatAPI 側の一時的な問題（`internal_error`、`processing_*`）                 | `request_id` を保存し、バックオフして再試行。[エラー](/errors#text-endpoints)を参照 |

### 利用量と料金の確認

ダッシュボードで API キー別の呼び出し数、トークン数、料金を確認できます。[`GET /v1/usage`](/quick-guide) でも同じ数値を取得できます。

## サポート

[ダッシュボード](https://beatapi.io/dashboard)からチケットを作成し、失敗したレスポンスの `request_id` を添えてください。