> 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.

# ChatBox で BeatAPI を使う

> ChatBox の OpenAI、Claude、Gemini の接続タイプで BeatAPI を設定します。

# ChatBox で BeatAPI を使う

ChatBox はクロスプラットフォームのデスクトップチャットクライアントです。BeatAPI は OpenAI、Anthropic、Gemini のリクエスト形式に対応しているため、使いたいモデルに合わせた接続タイプを選べます。

## 前提条件

1. **ChatBox がインストールされていること。** Windows、macOS、Linux、または Web 版を利用します。
2. **BeatAPI API キー。** [ダッシュボード → API キー](https://beatapi.io/dashboard/apikeys)で作成します。

## ステップ 1：設定を開く

初回起動ではセットアップウィザードが表示されます。**Use your own API Key or local model** を選択します。

設定済みの場合は、左下の歯車アイコン、または `Ctrl+,`（macOS は `Cmd+,`）で設定を開きます。

## ステップ 2：接続タイプとホストを指定する

各タイプが付加するパスが異なるため、API Host も異なります。この設定の誤りが最もよくある原因です。

| 接続タイプ      | API Host                    | 主な対象                                            |
| ---------- | --------------------------- | ----------------------------------------------- |
| OpenAI API | `https://api.beatapi.io`    | GPT、DeepSeek、GLM、Kimi、MiniMax、Qwen、MiMo、Hunyuan |
| Claude API | `https://api.beatapi.io/v1` | Claude モデル                                      |
| Gemini API | `https://api.beatapi.io/`   | Gemini モデル                                      |

どの場合も、同じ BeatAPI キーを API Key に指定します。

> **Note**
>
> アカウントのすべてのモデルをどの形式でも呼び出せます。接続タイプは ChatBox が送る形式の選択であり、利用可能なモデルを限定しません。OpenAI タイプは `/v1/chat/completions`、Claude タイプは `/messages`、Gemini タイプは `v1beta/models/...` を付加するため、ホストだけが異なります。上記の組み合わせは、すべて実在する BeatAPI エンドポイントに接続します。

## ステップ 3：モデルを選ぶ

ドロップダウンから選ぶか、一覧が更新されていない場合は ID を入力します。

| モデル ID                      | 接続タイプ      | 用途                  |
| --------------------------- | ---------- | ------------------- |
| `gpt-6-astra`               | OpenAI API | 最新世代の OpenAI        |
| `gpt-5.6-terra`             | OpenAI API | バランスのよい日常チャット       |
| `claude-fable-5-1`          | Claude API | 最新世代の Claude        |
| `claude-haiku-4-5-20251001` | Claude API | 高速、低価格              |
| `gemini-3.7-flash`          | Gemini API | 高速、マルチモーダル          |
| `deepseek-v4-pro-0813`      | OpenAI API | 低価格で高い推論性能          |
| `glm-5.3-flash`             | OpenAI API | 大量のチャット向けの最も低価格なモデル |

全モデルは [Text API](/text-api) と[料金ページ](https://beatapi.io/pricing)に掲載しています。

### 任意のパラメーター

| パラメーター      | 効果       | 推奨値                    |
| ----------- | -------- | ---------------------- |
| Temperature | 出力のランダム性 | 創作は `0.7`、正確さ重視は `0.3` |
| Max Tokens  | 出力の長さの上限 | 2000–4000              |
| Top P       | 核サンプリング  | `0.9`                  |

多くの会話では出力側の料金が高いため、Max Tokens の設定が最も簡単なコスト管理です。

## よくある質問

### ChatBox が接続できません

1. 上の表と API Host を照合します。`/v1` の有無はタイプによって異なります。
2. [ダッシュボード → API キー](https://beatapi.io/dashboard/apikeys)でキーが有効か確認します。

### BeatAPI のモデルが一覧に表示されません

モデル欄に ID を直接入力してください。ID は大文字と小文字を区別します。[料金ページ](https://beatapi.io/pricing)に掲載しています。

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

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

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

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

## サポート

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