문서

Chatbox

Chatbox는 엔드포인트를 호스트와 경로로 나누고 경로를 자동으로 채웁니다. 따라서 호스트에는 출처(origin) 주소만 입력해야 합니다. 여기에 /v1을 넣는 것이 이 클라이언트에서 저지르기 쉬운 실수입니다.

OpenAI API Compatible 유형의 제공자를 추가하고 API Host를 서비스 루트로 설정하세요 — Chatbox가 자체적으로 /v1/chat/completions를 추가합니다

Chatbox 설정

Settings → Model Providers → Add

  API 提供方名称 / Provider name   Kunavo
  API 类型 / Type                 OpenAI API 兼容 (OpenAI API compatible)
  API 密钥 / API Key              sk-kn-...
  API 主机 / API Host             https://api.kunavo.com
  API 路径 / API Path             (leave empty → /v1/chat/completions)
  Model                           claude-sonnet-5

API Host에는 https://api.kunavo.com를 입력하고 /v1는 포함하지 마세요. Chatbox에는 기본값이 /v1/chat/completions인 API Path 필드가 별도로 있으므로, 호스트가 이미 /v1로 끝나면 요청은 /v1/v1/chat/completions로 전송됩니다. 다른 경로가 필요하다는 것을 알고 있는 경우가 아니라면 경로를 비워 두세요.

Chatbox의 공급자 유형 선택기는 전송 형식을 지정합니다. OpenAI API 호환을 선택한 뒤 Claude 모델 ID를 입력하세요. ID는 엔드포인트에서 확인되므로 두 설정은 서로 충돌하지 않습니다.

아직 키가 없나요? Kunavo 계정을 만들고, 키를 생성한 다음(키는 sk-kn-로 시작합니다) $10부터 크레딧을 추가하세요. 호출 비용은 해당 잔액에서 차감되며 실패한 호출에는 요금이 부과되지 않습니다. 그러면 대시보드가 Chatbox 설정 화면에서 열립니다.

단계별 안내

/app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
Settings → Model Providers를 열고 Add를 클릭합니다.
공급자 이름을 지정하고 유형을 OpenAI API 호환으로 설정한 다음 API Key를 붙여 넣습니다.
API 主机 / API Host를 https://api.kunavo.com로 설정하고 API 路径 / API Path는 비워 둡니다.
원하는 모델 ID를 추가하고 저장한 다음 대화를 시작합니다.

Chatbox 공급자 구성 가이드에서 확인했습니다(2026년 9월 6일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Chatbox에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

모델 ID	Kunavo 입력/출력	Chatbox에서의 위치
`claude-sonnet-5`	$1.40 / $7.00	기본 대화 모델
`claude-haiku-4-5`	$0.70 / $3.50	지연 시간과 가격이 모두 중요한 짧은 대화
`claude-opus-5`	$3.50 / $17.50	어려운 질문에 대비해 보조 공급자 항목으로 추가
`gpt-5-6-terra`	$0.70 / $4.20	동일한 키로 사용하는 다른 모델 계열

월정액 없이 선불 잔액에서 토큰별로 청구됩니다. billing을 참고하세요. 반복되는 컨텍스트(에디터나 채팅 클라이언트가 보내는 데이터의 대부분)에서는 모델 선택보다 프롬프트 캐싱이 청구액에 더 큰 영향을 줍니다.

자주 묻는 질문

OpenAI 호환 엔드포인트에서 Chatbox의 API Host는 무엇으로 설정해야 하나요?

경로를 제외한 origin입니다. 예를 들어 https://api.example.com과 같습니다. Chatbox에는 기본값이 /v1/chat/completions인 별도의 API Path 필드가 있습니다. 문서에서는 일반적으로 이 필드를 입력할 필요가 없다고 안내하므로, /v1은 호스트가 아니라 경로에서 가져옵니다. 호스트를 /v1로 끝내면 요청이 /v1/v1/chat/completions로 전송되어 404가 발생합니다.

Chatbox에 사용자 지정 모델 공급자를 추가하려면 어떻게 하나요?

Settings → Model Providers를 열고 Add를 클릭합니다. 공급자 이름을 입력하고 OpenAI 호환 API 유형을 선택한 뒤 API 키를 붙여 넣습니다. API Host에는 엔드포인트의 origin을 입력하고 API Path는 비워 둡니다. 사용할 모델 ID를 추가하고 저장하면 모든 대화의 모델 선택기에 해당 공급자가 표시됩니다.

Chatbox에서 Claude 모델을 사용할 수 있나요?

해당 모델을 제공하는 OpenAI 호환 엔드포인트를 통해 사용할 수 있습니다. Chatbox는 입력한 모델 ID를 설정된 호스트로 전송하므로 Claude ID는 Chatbox가 아니라 해당 엔드포인트에서 확인됩니다. 앱에 별도의 Anthropic 자격 증명을 입력할 필요가 없습니다. 공급자 유형 선택기는 업체가 아닌 전송 형식을 지정합니다.

Chatbox의 API Path는 언제 입력해야 하나요?

엔드포인트가 /v1/chat/completions에서 채팅 완료 요청을 제공하지 않을 때만 입력합니다. 이 필드는 특수한 라우팅을 사용하는 게이트웨이를 위한 것입니다. 표준 OpenAI 호환 서비스라면 비워 두는 것이 맞습니다. 경로를 입력하면 인증 문제처럼 보이는 404가 발생하는 경우가 많습니다.