# Chatbox

Chatbox는 사용자 지정 OpenAI-API-compatible 공급자를 지원합니다. Host와 키를 입력한 뒤 원하는 모델을 추가하세요.

> https://nezhagate.com/ko/docs/integrations/chatbox

작성 기준 버전: Chatbox 1.23

## 공급자 추가하기

1. **Settings** → **Model Provider**를 열고 아래쪽의 **Add**를 클릭하세요.

2. 이름을 입력하고 **API Mode**에서 **OpenAI API Compatible**을 선택하세요.

3. 아래 표대로 키와 주소를 입력하세요.

4. 입력란 아래의 **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`로 설정해 공급자를 하나 더 추가하세요.

## 자주 나오는 오류

**404, 주소에 /v1이 두 번 들어갈 때**

Host가 이미 `/v1`로 끝나므로 Path는 비워 둬야 합니다. 그렇지 않으면 주소가 `/v1/v1/chat/completions`가 됩니다.

**404, 주소에 /v1이 없을 때**

Host는 `/v1`까지 입력해야 합니다: `https://nezhagate.com/v1`.

**Connection failed / Failed to fetch models**

키를 빠짐없이, 공백 없이 복사했는지, 잔액이 충분한지 확인하세요. 웹 버전에서는 Improve Network Compatibility도 켜야 합니다.