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

# Cherry StudioでElkAPIを使用する

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

## 準備

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

1. **Cherry Studioがインストールされている**\
   [Cherry Studio公式サイト](https://cherry-ai.com/)からお使いのOSに適したバージョンをダウンロードしてインストールしてください

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

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

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

Cherry Studioを起動後、設定ページに移動します：

1. 右上の\*\*⚙️ 設定\*\*アイコン（歯車アイコン）をクリック
2. またはキーボードショートカットを使用：
   * Windows/Linux: `Ctrl + ,`
   * macOS: `Cmd + ,`

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cherry-studio/main-interface.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=ef3f913c9b4888b65c903676b6cd9292" alt="Cherry Studio メインインターフェース" width="960" height="600" data-path="images/integrations/cherry-studio/main-interface.png" />
</Frame>

<caption>*Cherry Studio メインインターフェース、右上の歯車アイコンをクリックして設定に入る*</caption>

## ステップ2：ElkAPIモデルプラットフォームを追加

### 2.1 モデルサービス管理にアクセス

設定ページで：

1. 左側メニューの**モデルサービス**オプションを見つける
2. クリックしてモデルサービス管理ページに入る

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cherry-studio/settings-providers.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=39ebb46b27592e425b4e3596bda8aaa4" alt="Cherry Studio 設定 - モデルサービス" width="960" height="600" data-path="images/integrations/cherry-studio/settings-providers.png" />
</Frame>

<caption>*設定ページの左側メニューで「モデルサービス」オプションを見つける*</caption>

### 2.2 ElkAPI プロバイダーを追加

1. モデルサービスページの下部にある\*\*「+ 添加」\*\*ボタンをクリック

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/cherry-studio/add-provider-config.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=dd6131d04011686edb4b296130ac9344" alt="プロバイダー追加ダイアログ" width="960" height="600" data-path="images/integrations/cherry-studio/add-provider-config.png" data-path="images/integrations/cherry-studio/add-provider-config.png" />
</Frame>

<caption>*「+ 添加」をクリックするとプロバイダー追加ダイアログが表示されます*</caption>

2. \*\*「プロバイダーを追加」\*\*ダイアログで入力：
   * **プロバイダー名**：`ElkAPI`（カスタマイズ可能）
   * **プロバイダータイプ**：`OpenAI`を選択

3. \*\*「確定」\*\*ボタンをクリック

### 2.3 ElkAPI API 情報を設定

プロバイダーを追加後、右側の設定エリアでAPI情報を入力：

| 設定項目         | 入力内容                                |
| ------------ | ----------------------------------- |
| **API キー**   | お客様のElkAPI APIキー（`sk-xxxxxxxxxxxx`） |
| **API アドレス** | `https://api.elkapi.com`            |

<Note>
  **重要：**

  * API アドレスは`https://api.elkapi.com`である必要があります（`/v1`やその他のパスを含めないでください）
  * API キーは、ElkAPIコンソールから取得した`sk-`で始まるキーである必要があります
  * 入力後、\*\*「検測」\*\*ボタンをクリックして接続をテストできます
</Note>

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/cherry-studio/settings.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=8d89a921e53ab99880d591d88efa9e22" alt="ElkAPI API 情報を設定" width="960" height="600" data-path="images/integrations/cherry-studio/settings.png" data-path="images/integrations/cherry-studio/settings.png" />
</Frame>

<caption>*APIキーとAPIアドレスを入力し、ElkAPIプロバイダーの状態がON（緑色のスイッチ）であることを確認*</caption>

## ステップ3：モデルを追加して管理

### 3.1 モデル管理を開く

ElkAPIプロバイダーの設定完了後：

1. ElkAPIプロバイダー右上のスイッチが**ON**（緑色）であることを確認
2. 右側の設定エリアで、\*\*「モデル」\*\*セクションを見つける
3. \*\*「管理」\*\*ボタンをクリックしてモデル選択ウィンドウを開く

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/cherry-studio/provider-list.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=1a20fb519ed1e5321011c370a07c239c" alt="ElkAPI モデル管理" width="960" height="600" data-path="images/integrations/cherry-studio/provider-list.png" data-path="images/integrations/cherry-studio/provider-list.png" />
</Frame>

<caption>*「管理」ボタンをクリックしてElkAPIモデル選択ウィンドウを開く*</caption>

### 3.2 必要なモデルを追加

表示されたモデル選択ウィンドウで：

1. 検索ボックスを使用して特定のモデルを検索できます
2. 上部の分類タブでフィルタリング：**全部**、**推理**、**視覚**、**聯網**、**免費**、**嵌入**、**重排**、**工具**
3. 使用したいモデルを見つけて、右側の\*\*+\*\*ボタンをクリックして追加：
   * `gpt-5.5` / `gpt-5.5-pro` - OpenAI GPT-5.5モデル
   * `gpt-5.4-mini` - より高速で経済的なバージョン
   * `claude-sonnet-4-6` シリーズ - Claude Sonnet 4.6モデル（複数の変体を含む）
   * `claude-sonnet-4-6-thinking` - Claude Sonnet 4.6 Thinking
   * `claude-sonnet-4-6` - Claude Sonnet 4.6
   * `gemini-3.1-flash-lite-preview` - Google Gemini 3.1 Flash Lite

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/cherry-studio/model-selection.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=75ec1f4d1a215a6be6cc1534fccf7332" alt="追加されたモデルリスト" width="960" height="600" data-path="images/integrations/cherry-studio/model-selection.png" data-path="images/integrations/cherry-studio/model-selection.png" />
</Frame>

<caption>*追加されたモデルは右側に表示され、展開して具体的な変体を確認できます*</caption>

4. 必要なモデルをすべて追加したら、モデル選択ウィンドウを閉じます

<Tip>
  **推奨モデル：**

  * 💰 **コストパフォーマンス：** `gpt-5.4-mini`、`claude-sonnet-4-6`
  * 🚀 **高性能：** `gpt-5.5` / `gpt-5.5-pro`、`claude-sonnet-4-6-thinking`
  * 🎨 **マルチモーダル：** `claude-sonnet-4-6` シリーズ、`gemini-3.1-flash-lite-preview`
</Tip>

## ステップ4：チャットを開始

設定完了後、使用を開始できます：

1. メインインターフェースに戻り、上部の\*\*「+」\*\*をクリックするか既存のチャットを選択
2. チャットページ上部で、モデルセレクターをクリック
3. **ElkAPI**プロバイダー下のモデルを選択
4. AIとのチャットを開始！

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/cherry-studio/new-chat.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=7ec831a2bfbdf702661cda06618b6392" alt="新しいチャット" width="960" height="600" data-path="images/integrations/cherry-studio/new-chat.png" data-path="images/integrations/cherry-studio/new-chat.png" />
</Frame>

<caption>*新しいチャットを作成してElkAPIプロバイダーとモデルを選択*</caption>

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/cherry-studio/chat-interface.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=c9dbae284e89e7d3c9c498089d9bdd35" alt="チャットインターフェース" width="960" height="600" data-path="images/integrations/cherry-studio/chat-interface.png" data-path="images/integrations/cherry-studio/chat-interface.png" />
</Frame>

<caption>*Cherry Studio チャットインターフェースの例*</caption>

## よくある質問

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

**解決策：**

1. **Base URLを確認**：
   * Base URLが`https://api.elkapi.com`であることを確認
   * `/v1`サフィックスを追加しないでください

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

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

### Q2：モデルリストが空または更新できない？

**解決策：**

1. **手動でモデルを追加**：
   * 自動更新が失敗した場合、一般的なモデルを手動で追加できます
   * モデル管理で、モデル名を手動で入力（例：`gpt-5.5`）

2. **API権限を確認**：
   * API Keyにモデルリストへのアクセス権限があることを確認
   * ElkAPIサポートに連絡してアカウントステータスを確認

### 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呼び出し統計
* 💰 料金詳細
* 📈 使用トレンドチャート

## 機能

Cherry Studio + ElkAPIを使用すると、以下が可能です：

* 💬 **マルチモデル会話** - 同じインターフェースで異なるAIモデルを使用
* 🖼️ **画像理解** - 画像入力をサポートするマルチモーダル会話
* 📝 **コンテキスト管理** - 会話履歴とコンテキストのインテリジェント管理
* 🎨 **カスタムプロンプト** - プロンプトテンプレートの作成と管理
* 📊 **会話エクスポート** - 会話記録をMarkdownなどの形式でエクスポート
* 🔄 **モデル比較** - 複数のモデルを同時に使用して出力を比較

## サポート＆ヘルプ

問題が発生した場合：

* 📚 [ElkAPIドキュメント](https://docs.elkapi.com)
* 📧 テクニカルサポート：[support@elkapi.com](mailto:support@elkapi.com)

***

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