Cherry Studio で BeatAPI を使う

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

前提条件

Cherry Studio がインストールされていること。 公式サイトから入手します。
BeatAPI API キー。 ダッシュボード → API キーで作成します。

ステップ 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`

/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 と料金ページに掲載しています。必要なだけ追加でき、チャット上部のドロップダウンで切り替えられます。

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

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

よくある質問

Cherry Studio が接続できません

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

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

モデル管理画面で ID を手動で追加してください。ID は料金ページに掲載しており、大文字と小文字を区別します。

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

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

利用量と料金の確認

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

サポート

ダッシュボードからチケットを作成し、失敗したレスポンスの request_id を添えてください。