---
title: "Chatbox 원클릭 가져오기 및 구성"
description: "API Key 페이지에서 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. 짧은 메시지를 하나 보내고 이 사이트의 호출 로그에서 모델과 요청 시간을 확인합니다.
## 클립보드 및 수동 구성
앱이 열리지 않으면 같은 패널에서 **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 키](/ko/docs/api-keys/), [모델 목록](/ko/docs/models/), [호출 로그](/ko/docs/usage-logs/), [주소 설명](/ko/docs/base-url/).