Chatbox 설정 가이드
Chatbox는 일상 대화, 번역, 카피라이팅 및 간단한 이미지 이해에 적합한 도구입니다. 설정 인터페이스가 직관적이어서 Key, Base URL, 모델명 입력 방법을 처음 배우는 초보자에게 안성맞춤입니다.
공식 정보 다운로드 및 문서는 공식 사이트 기준을 따릅니다.
어떤 용도에 적합한가요?
텍스트 대화번역 및 재작성다중 모델 전환초보자 추천
설정 전 확인 사항
| 준비 사항 | 확인 경로 | 초보자 주의사항 |
|---|---|---|
| API Key | 제공자 백엔드의 토큰, Key 또는 API Key 페이지 | Key 자체만 복사하고 별칭, 생성 시간 또는 앞뒤 공백은 포함하지 마세요. |
| Base URL / API Host | 제공자 백엔드의 API 주소, 인터페이스 주소 또는 엔드포인트 | 주소 전체를 복사하세요. /v1 포함 여부는 백엔드 예시를 따릅니다. |
| Model ID / Model Name | 제공자 백엔드 모델 목록 | 모델 목록에서 선택하는 것을 권장하며, 목록이 없다면 백엔드에서 제공하는 원래 식별자를 직접 입력하세요. |
| 잔액 및 권한 | 제공자 백엔드의 잔액, 모델 그룹 또는 사용 가능한 모델 | 잔액이 부족하거나 모델 권한이 없으면 설정이 올바르더라도 호출에 실패할 수 있습니다. |
설정 항목은 어떻게 입력하나요?
| 설정 항목 | 입력 방법 |
|---|---|
| Provider | OpenAI API / OpenAI Compatible |
| API Key | 제공자 백엔드에서 복사한 Key |
| API Host / Base URL | 제공자 백엔드에서 제공하는 전체 API 주소(/v1 포함 여부는 제공자 기준) |
| Model | 제공자 모델 목록에 있는 모델명 |
설정 단계
- Chatbox를 실행하고 Settings(설정) 또는 Model provider(모델 제공자)로 이동합니다.
- 서비스 유형으로 OpenAI API, OpenAI Compatible 또는 이와 유사한 항목을 선택합니다.
- 제공자 백엔드에서 복사한 API Key를 붙여넣습니다.
- API Host / Base URL을 제공자에서 안내한 API 주소로 변경합니다. 임의로
/v1을 추가하거나 삭제하지 마세요. - 제공자가 지원하는 모델명(예:
gpt-4.1,deepseek-chat또는 백엔드에 표시된 원래 식별자)을 입력합니다. - 저장 후 새 대화를 시작하여 테스트 메시지를 전송합니다.
| 설정 항목 | 입력 방법 | 초보자가 자주 하는 실수 |
|---|---|---|
| API Key | 전체 Key 복사 | 앞뒤에 불필요한 공백 포함, 메모/별칭 복사, 비활성화된 Key 사용 |
| Base URL | 백엔드에서 제공한 API 주소 복사 | 공식 홈페이지 주소, 콘솔 주소, API 주소를 혼동 |
| Model | 모델 목록 복사 | 표시용 이름을 모델명으로 입력하거나 대소문자/하이픈 오기입 |
채팅창에 복사해 테스트할 문장
Please reply only: Configuration successful| 테스트 결과 | 우선 점검 사항 | 해결 방법 |
|---|---|---|
| Unauthorized / invalid api key 오류 발생 시 | API Key | Key를 다시 복사하고, 앞뒤 공백이 없는지, Key가 비활성화되거나 만료되지 않았는지 확인하세요. |
| model not found 오류 발생 시 | Model ID / Model Name | 제공자 백엔드의 모델 목록에서 원본 식별자(ID)를 복사해 입력하세요. 표시용 이름을 입력하지 마세요. |
| 연결 시간 초과 또는 네트워크 오류 발생 시 | Base URL / API Host | 공식 홈페이지나 콘솔 주소가 아닌 실제 API 주소를 정확히 입력했는지 확인하세요. |