> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elkapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ChatBox で ElkAPI を使用する

> ChatBox デスクトップクライアントで ElkAPI API サービスを設定して使用する方法の詳細ガイド。このガイドでは、ChatBox で ElkAPI API を設定し、豊富な AI モデルリソースにアクセスする方法を説明します。

## 準備

始める前に、以下を確認してください：

1. **ChatBox がインストールされている**\
   [ChatBox GitHub](https://github.com/Bin-Huang/chatbox) からお使いの OS に適したバージョンをダウンロードしてインストールするか、[ChatBox 公式サイト](https://chatboxai.app/) にアクセスしてください

2. **ElkAPI API キーを取得済み**\
   [ElkAPI コンソール](https://api.elkapi.com/keys) にログインして、API キー（`sk-` で始まる）を取得してください

<Note>
  **ヒント：** ElkAPI アカウントをお持ちでない場合は、まず [ElkAPI](https://api.elkapi.com) で登録して API キーを取得してください。
</Note>

## ステップ 1: ChatBox を起動して設定を開始

ChatBox を初めて起動するか、新しい AI プロバイダーを追加する場合：

1. ChatBox アプリケーションを起動します
2. 初回使用時は、設定ウィザードが自動的に表示されます
3. **「自分の API Key またはローカルモデルを使用」** ボタンをクリックします
4. すでに設定済みの場合は、左下の **⚙️ 設定** アイコンをクリックするか、ショートカット `Ctrl+,` (Windows/Linux) / `Cmd+,` (macOS) を使用します

<Frame>
  <img src="https://mintcdn.com/apicore/60dm1rHMQir4d9rs/images/integrations/chatbox/main-interface.png?fit=max&auto=format&n=60dm1rHMQir4d9rs&q=85&s=97330aedf8be26446c3a8d9e4386f0bd" alt="ChatBox 設定ウィザード" width="1023" height="768" data-path="images/integrations/chatbox/main-interface.png" />
</Frame>

<caption>*ChatBox 設定ウィザード、自分の API Key を使用することを選択*</caption>

## ステップ 2: ElkAPI API を設定する

### 2.1 AI モデルプロバイダーを選択

設定ページで：

1. **AI Provider** 設定を見つけます
2. ドロップダウンメニューから **OpenAI API**（GPT シリーズモデル用）、**Claude API**（Claude シリーズモデル用）、または **Gemini API**（Gemini シリーズモデル用）を選択します

<Frame>
  <img src="https://mintcdn.com/apicore/60dm1rHMQir4d9rs/images/integrations/chatbox/settings-page.png?fit=max&auto=format&n=60dm1rHMQir4d9rs&q=85&s=f53a32eb9ce38bd30aa3d631a6582a88" alt="ChatBox 設定ページ" width="1023" height="768" data-path="images/integrations/chatbox/settings-page.png" />
</Frame>

<caption>*ChatBox 設定ページ、プロバイダーとして OpenAI API を選択*</caption>

### 2.2 API 情報を設定

OpenAI API を選択したら、以下の設定を入力します：

| 項目                              | 値                                |
| ------------------------------- | -------------------------------- |
| **API Key**                     | ElkAPI API キー（`sk-xxxxxxxxxxxx`） |
| **API Host** または **API Domain** | `https://api.elkapi.com`         |

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/chatbox/api-config.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=f0a3d153bf9c07e038e4cad1c30a958b" alt="API 設定" width="1023" height="768" data-path="images/integrations/chatbox/api-config.png" data-path="images/integrations/chatbox/api-config.png" />
</Frame>

Claude API を選択したら、以下の設定を入力します：

| 項目                              | 値                                |
| ------------------------------- | -------------------------------- |
| **API Key**                     | ElkAPI API キー（`sk-xxxxxxxxxxxx`） |
| **API Host** または **API Domain** | `https://api.elkapi.com/v1`      |

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/chatbox/claude.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=ecf85e7758e4e494ffa4023d90f8e1db" alt="claude モデル" width="1023" height="768" data-path="images/integrations/chatbox/claude.png" data-path="images/integrations/chatbox/claude.png" />
</Frame>

Gemini API を選択したら、以下の設定を入力します：

| 項目                              | 値                                |
| ------------------------------- | -------------------------------- |
| **API Key**                     | ElkAPI API キー（`sk-xxxxxxxxxxxx`） |
| **API Host** または **API Domain** | `https://api.elkapi.com/`        |

<caption>*ElkAPI の API Key と API Host を入力*</caption>

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/chatbox/Gemini.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=2fc481799906695ae84aecd010fe914a" alt="Gemini" width="1023" height="768" data-path="images/integrations/chatbox/Gemini.png" data-path="images/integrations/chatbox/Gemini.png" />
</Frame>

<Warning>
  **重要：**

  * OpenAI API を使用する場合、API Host は `https://api.elkapi.com` にしてください（`/v1` サフィックスなし）
  * Claude API を使用する場合、API Host は `https://api.elkapi.com/v1` にしてください（`/v1` サフィックス付き）
  * Gemini API を使用する場合、API Host は `https://api.elkapi.com/` にしてください（`/v1` サフィックスなし）
  * API Key は ElkAPI コンソールから取得した `sk-` で始まるものである必要があります
  * API キーに十分な残高があることを確認してください
</Warning>

### 2.3 モデルを選択

設定完了後、**Model** ドロップダウンから使用したいモデルを選択します：

**推奨モデル：**

| モデル名                  | モデル ID                          | 特徴        |
| --------------------- | ------------------------------- | --------- |
| GPT-5                 | `gpt-5.5`                       | 最新かつ最も強力  |
| GPT-5.5               | `gpt-5.5` または `gpt-5.5-pro`     | 高品質な会話    |
| GPT-5.4 Mini          | `gpt-5.4-mini`                  | 高速で経済的    |
| Claude Sonnet 4.6     | `claude-sonnet-4-6`             | コードに優れる   |
| Claude Opus 4.7       | `claude-sonnet-4-6`             | 高速応答      |
| Gemini 3.1 Flash Lite | `gemini-3.1-flash-lite-preview` | マルチモーダル対応 |

<Warning>
  **Claude モデル使用時の特別な手順：**

  Claude モデル（`claude-sonnet-4-6` や `claude-sonnet-4-6` など）を使用する場合は、以下の追加設定が必要です：

  1. **Claude API プロバイダーに切り替え**：
     * 設定で **AI プロバイダー** を **Claude API** に変更します
     * API Host は `https://api.elkapi.com/v1` のままにします
     * API Key は ElkAPI の API キー（`sk-xxxxxxxxxxxx`）を使用します

  2. **またはカスタムリクエストヘッダーを追加**（OpenAI API プロバイダーを使用する場合）：
     * 一部のバージョンの ChatBox はカスタムヘッダーの追加に対応しています
     * 詳細設定でリクエストヘッダーを追加：`anthropic-version: 2023-06-01`

  **推奨方法：** GPT シリーズモデルには **OpenAI API**、Claude シリーズモデルには **Claude API**、Gemini シリーズモデルには **Gemini API** を使用してください。
</Warning>

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/chatbox/model-selection.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=36cc34f8949089747285a49dd14a1d27" alt="モデル選択" width="1023" height="768" data-path="images/integrations/chatbox/model-selection.png" data-path="images/integrations/chatbox/model-selection.png" />
</Frame>

<caption>*リストから目的の AI モデルを選択*</caption>

<Tip>
  **パフォーマンス推奨：**

  * 💰 **コスト効率:** `gpt-5.4-mini`、`claude-sonnet-4-6`
  * 🚀 **高性能:** `gpt-5.5`、`gpt-5.5-pro`、`claude-sonnet-4-6`
  * ⚡ **高速応答:** `gemini-3.1-flash-lite-preview`、`gpt-5.4-mini`
</Tip>

## ステップ 3: 使用開始

設定が完了したら、ChatBox で AI との会話を開始できます：

1. メインインターフェースに戻ります
2. 入力ボックスに質問や要求を入力します
3. `Enter` キーを押すか、送信ボタンをクリックします
4. AI が ElkAPI のモデルを使用して返信を生成します

<Frame>
  <img src="https://mintcdn.com/apicore/60dm1rHMQir4d9rs/images/integrations/chatbox/chat-interface.png?fit=max&auto=format&n=60dm1rHMQir4d9rs&q=85&s=3bdd5a9f07e4d0610520c71d0ff2d599" alt="チャットインターフェース" width="1023" height="768" data-path="images/integrations/chatbox/chat-interface.png" />
</Frame>

<caption>*ChatBox チャットインターフェース、AI との会話を開始*</caption>

### モデルパラメータの調整（オプション）

必要に応じて以下のパラメータを調整できます：

| パラメータ           | 説明                 | 推奨値                |
| --------------- | ------------------ | ------------------ |
| **Temperature** | 出力のランダム性を制御        | 0.7（創造的） / 0.3（正確） |
| **Max Tokens**  | 最大出力長              | 2000-4000          |
| **Top P**       | ニュークリアスサンプリングパラメータ | 0.9                |

## 高度な機能

### マルチセッション管理

ChatBox は複数の会話セッションの作成をサポートしています：

1. **新規チャット** ボタンをクリックします
2. 異なるタスクのために独立したセッションを作成できます
3. 左側のセッションリストで会話を切り替えます

### 会話の保存とエクスポート

1. 会話セッションを右クリックします
2. **エクスポート** オプションを選択します
3. Markdown、JSON などの形式でエクスポートできます

### プロンプトテンプレートの使用

1. 設定メニューで **Prompts** 設定を見つけます
2. よく使うプロンプトテンプレートを保存できます
3. 会話中にプリセットのプロンプトをすばやく呼び出します

## FAQ

### Q1: ElkAPI サービスに接続できない？

**解決策：**

1. **API Host を確認**：
   * `https://api.elkapi.com` であることを確認
   * `/v1` やその他のパスを追加しないでください

2. **API Key を検証**：
   * API Key が `sk-` で始まることを確認
   * [ElkAPI コンソール](https://api.elkapi.com/keys) でキーが有効か確認してください

3. **ネットワーク接続を確認**：
   * `https://api.elkapi.com` にアクセスできることを確認
   * 中国国内の場合、プロキシの設定が必要な場合があります

### Q2: モデルリストに ElkAPI のモデルが表示されない？

**解決策：**

1. **モデル名を手動入力**：
   * モデル入力ボックスに直接モデル ID を入力します
   * 例：`gpt-5.5`、`gpt-5.4-mini`、`claude-sonnet-4-6`

2. **モデルリストを更新**：
   * ChatBox アプリケーションを再起動します
   * API 情報を再設定します

### Q3: 会話中にエラーメッセージが表示される？

**一般的なエラーと解決策：**

| エラーメッセージ                    | 原因                 | 解決方法                |
| --------------------------- | ------------------ | ------------------- |
| `401 Unauthorized`          | 無効または期限切れの API Key | API Key を再取得して設定を更新 |
| `429 Too Many Requests`     | リクエストレート制限超過       | しばらく待ってから再試行        |
| `500 Internal Server Error` | サーバーの一時的な問題        | 数分待ってから再試行          |
| `insufficient_quota`        | アカウント残高不足          | コンソールでチャージ          |

### Q4: API 使用状況と費用を確認する方法は？

[ElkAPI コンソール](https://api.elkapi.com) にログインして確認：

* 📊 API 呼び出し統計
* 💰 費用明細
* 📈 使用傾向チャート
* 🔍 詳細なリクエストログ

### Q5: ChatBox はどのプラットフォームに対応していますか？

ChatBox は複数のプラットフォームに対応しています：

* 🪟 **Windows** - Windows 10/11
* 🍎 **macOS** - macOS 10.15+
* 🐧 **Linux** - 主要なディストリビューション
* 🌐 **Web** - ブラウザ版

## 使用のヒント

### 1. キーボードショートカット

ChatBox のキーボードショートカットを活用して効率化：

| ショートカット            | 機能         |
| ------------------ | ---------- |
| `Ctrl/Cmd + Enter` | メッセージ送信    |
| `Ctrl/Cmd + N`     | 新規チャット     |
| `Ctrl/Cmd + K`     | 会話検索       |
| `Ctrl/Cmd + ,`     | 設定を開く      |
| `Ctrl/Cmd + /`     | キーボードヘルプ表示 |

### 2. プロンプトの最適化

より良い応答を得るために、より良いプロンプトを書きます：

**❌ 悪いプロンプト：**

```
コードを書いて
```

**✅ 良いプロンプト：**

```
以下の機能を実装する Python 関数を書いてください：
1. 文字列のリストを入力として受け取る
2. 3 文字未満の文字列をフィルタリング
3. アルファベット順にソートした結果を返す
詳細なコメントと使用例を含めてください
```

### 3. 会話履歴を活用

ChatBox は会話履歴を保存します：

* AI は現在のセッションのコンテキストを記憶します
* 以前の応答に基づいて質問を続けられます
* 深い議論と反復に適しています

### 4. モデルの切り替え

異なるタスクに適したモデルに切り替え：

* **執筆タスク** - `gpt-5.5` または `claude-sonnet-4-6` を使用
* **コーディングタスク** - `claude-sonnet-4-6` を使用
* **クイック Q\&A** - `gpt-5.4-mini` を使用
* **マルチモーダル** - `gemini-3.1-flash-lite-preview` を使用

## 機能

ChatBox + ElkAPI を使用すると：

* 💬 **スムーズな会話** - リアルタイムのストリーミング出力でよりスムーズな体験
* 🎯 **マルチセッション管理** - 複数の独立した会話を同時に管理
* 💾 **ローカルストレージ** - プライバシー保護のため会話記録をローカルに保存
* 📤 **会話のエクスポート** - 複数の形式でのエクスポートをサポート
* 🎨 **シンプルなインターフェース** - シンプルで美しいユーザーインターフェース
* 🔒 **オープンソース & 無料** - 完全にオープンソースで無料使用
* 🌍 **クロスプラットフォーム** - Windows、macOS、Linux をサポート
* 🚀 **優れたパフォーマンス** - 軽量アプリケーション、スムーズな動作

## サポート & ヘルプ

問題が発生した場合：

* 📚 [ElkAPI ドキュメント](https://docs.elkapi.com)
* 📚 [ChatBox GitHub](https://github.com/Bin-Huang/chatbox)
* 📧 技術サポート：[support@elkapi.com](mailto:support@elkapi.com)

***

<Card title="ElkAPI を始める" icon="rocket" href="https://api.elkapi.com">
  今すぐ ElkAPI に登録して API キーを取得し、ChatBox で AI の旅を始めましょう！
</Card>