Chatbox
Chatbox는 사용자 지정 OpenAI-API-compatible 공급자를 지원합니다. Host와 키를 입력한 뒤 원하는 모델을 추가하세요.
공급자 추가하기
- Settings → Model Provider를 열고 아래쪽의 Add를 클릭하세요.
- 이름을 입력하고 API Mode에서 OpenAI API Compatible을 선택하세요.
- 아래 표대로 키와 주소를 입력하세요.
- 입력란 아래의 Preview 줄에 전체 엔드포인트가 표시되는지 확인하세요(표 아래 참고).
| 필드 | 값 |
|---|---|
| API Mode | OpenAI API Compatible |
| API Key | NezhaGate API 키 |
| API Host | https://nezhagate.com/v1 |
| API Path | 비워 두세요 |
Preview에는 https://nezhagate.com/v1/chat/completions이 표시되어야 합니다.
모델 추가하기
Fetch를 클릭해 모델 목록을 불러오거나, New로 직접 추가하세요(예: gpt-5.5). 채팅 모델만 추가하고, 각 모델이 지원하는 기능(이미지 입력, 추론, 도구 사용)에 체크하고 컨텍스트 창을 설정하세요. 설정하지 않은 모델은 텍스트 전용으로 처리됩니다.
테스트
Check를 클릭하세요. Chatbox가 선택한 모델에 짧은 테스트 몇 가지(텍스트, 이미지, 도구)를 보내고 Connection successful을 표시합니다. 텍스트 전용 모델에서 이미지와 도구 테스트가 실패하는 것은 문제가 되지 않습니다.
웹 버전
Chatbox 웹 버전은 브라우저에서 바로 API를 호출하는데, NezhaGate의 API는 브라우저의 크로스 오리진 요청을 받지 않습니다. 공급자 설정에서 Improve Network Compatibility를 켜면 요청이 Chatbox 서버를 거쳐 전달되며, 그 대신 데스크톱이나 모바일 앱을 쓸 수도 있습니다.
Claude(선택 사항)
API Mode를 Claude API Compatible로, API Host를 https://nezhagate.com/anthropic/v1로 설정해 공급자를 하나 더 추가하세요.
자주 나오는 오류
Host가 이미 /v1로 끝나므로 Path는 비워 둬야 합니다. 그렇지 않으면 주소가 /v1/v1/chat/completions가 됩니다.
Host는 /v1까지 입력해야 합니다: https://nezhagate.com/v1.
키를 빠짐없이, 공백 없이 복사했는지, 잔액이 충분한지 확인하세요. 웹 버전에서는 Improve Network Compatibility도 켜야 합니다.
