---
title: "Chatbox ワンクリックインポートと設定"
description: "API キーページから Chatbox をインポートし、API Host、パス、モデル、キーを確認します。"
headingIds: {"ワンクリックインポート":"section-1","クリップボードと手動設定":"section-2","トラブルシューティング":"section-3"}
---
Chatbox 1.15.1 以降、プロバイダー JSON と `chatbox://provider/import` に対応しています。デスクトップ版は先にインストールし、一度起動してください。ウェブ版、または登録プロトコルのないシステムでは、クリップボードからのインポートを使用してください。
## ワンクリックインポート
1. コンソールの **API キー** を開き、使用するキーを見つけ、**使用ツール → Chatbox** に入ります。
2. このキーで利用可能なチャットモデルを選択し、**Chatbox を開く** をクリックして、ブラウザでアプリを開くことを許可します。
3. Chatbox でインポートを確認し、プロバイダーのアドレスとモデルをチェックします。同名の設定が既にある場合は、まず上書き範囲を確認してください。
4. 簡単なメッセージを 1 通送信し、当サイトの呼び出しログでモデルとリクエスト時刻を確認してください。
## クリップボードと手動設定
アプリが起動しない場合は、同じパネルで **Chatbox JSON** をコピーし、Chatbox 設定のプロバイダー管理からクリップボードからのインポートを選択してください。他者に共有する前に `settings.apiKey` を必ず削除してください。
| フィールド | 値 |
| --- | --- |
| タイプ | OpenAI API compatible |
| API Host | `https://1zheai.com` |
| API Path | `/v1/chat/completions` |
| API Key | 現在のキー |
| Model ID | 現在のキーで利用可能なチャットモデル |
Host と Path は別々に入力し、`/v1` を両方のフィールドに同時に追加しないでください。モデルがない場合は、まずモデル一覧を取得するか手動で追加してください。画像、埋め込み、ツール呼び出しなどの機能はそれぞれ別に検証し、任意のモデルをチャットモデルとして扱わないでください。
## トラブルシューティング
- アプリがポップアップしない：インストール済みか、アプリを起動したことがあるかを確認し、ブラウザによるこのプロトコルのブロックを解除するか、クリップボードからのインポートを使用してください。
- インポート後に 401：キーが有効か、空白がないかを確認してください。
- 404：最終パスが `/v1/chat/completions` であり、重複して連結されていないことを確認してください。
- モデルが存在しない：モデル一覧に記載されている正確な ID を使用してください。表示上のニックネームから推測しないでください。
公式：[設定インポートプロトコル](https://docs.chatboxai.app/guides/providers/import-config)、[クライアントソースコード](https://github.com/chatboxai/chatbox/blob/main/src/renderer/utils/provider-config.ts)。
プロトコルと公式資料の照合は 2026-10-19 に実施しました。当サイトは設定生成とフロントエンドの回帰テストを実装済みです。すべてのクライアント、システム、モデルでの実際の推論検証は完了していません。クライアントのアップグレード後は再検証してください。カスタム接続は公式提携や組み込み推奨を意味しません。
詳細：[API キー](/ja/docs/api-keys/)、[モデル一覧](/ja/docs/models/)、[呼び出しログ](/ja/docs/usage-logs/)、[アドレス説明](/ja/docs/base-url/)。