문서
ChatWise
ChatWise에서는 모든 공급자 설정에 동일한 세 가지 입력란을 사용합니다. 사용자 지정 공급자의 이름, API Base URL, 키를 입력하고 Fetch를 누르면 모델 선택기에 Claude와 GPT ID가 표시됩니다. 두 모델은 하나의 잔액을 사용합니다.
Settings → Providers → "+"에서 세 필드 — Provider name, https://api.kunavo.com/v1로 설정한 API Base URL, API Key — 로 사용자 지정 제공자를 만들고 Fetch로 엔드포인트에서 모델 목록을 읽습니다
Provider name Kunavo
API Base URL https://api.kunavo.com/v1
field help: "Do NOT include /chat/completions in the URL"
API Key sk-kn-...
Models click Fetch to read the list from the endpoint,
or "+ New" and type an id by hand
"+ New" → Chat Models, the fields the docs name:
Model ID claude-sonnet-5
Display Name Claude Sonnet 5 (Kunavo)
Capabilities image input / reasoning flag — tick what the model does
Context length as published on the models page/v1를 포함해야 합니다. ChatWise는 필드 아래에 “URL에 /chat/completions를 포함하지 마세요”라는 규칙을 표시합니다. 따라서 값에는 경로가 아니라 경로가 이어지는 루트를 입력합니다. 문서에 나온 호스팅 게이트웨이 예시도 같은 형식인 https://aihubmix.com/v1를 사용합니다. URL에 경로까지 포함하면 인증 오류가 아닌 404 오류가 발생합니다.chatwise.app의 데스크톱 클라이언트(macOS, Windows, Linux)를 다루며, 관련 문서는 docs.chatwise.app에 있습니다. 공개 GitHub 릴리스 피드는 현재 제공되는 버전보다 훨씬 오래된 버전에서 업데이트가 멈췄습니다. 따라서 화면이 여기와 다르면 해당 피드가 아니라 앱 자체의 다운로드 버전을 확인하세요.sk-kn-로 시작합니다) $10부터 크레딧을 추가하세요. 호출 비용은 해당 잔액에서 차감되며 실패한 호출에는 요금이 부과되지 않습니다. 그러면 대시보드가 ChatWise 설정 화면에서 열립니다.단계별 안내
/app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.- ChatWise에서 Settings → Providers를 열고 “+”를 클릭해 새 공급자를 추가합니다. 문서에 따르면 여기서 두 가지 경로를 선택할 수 있습니다. 내장 프리셋을 선택하거나 사용자 지정 구성을 만들 수 있습니다. Kunavo는 프리셋이 아니므로 두 번째 방법을 선택하세요.
- 앞서 설명한 대로 Provider name, API Base URL, API Key를 입력합니다. 양식에서 업체를 선택하는 항목은 없습니다. 엔드포인트에서 모델 ID를 확인하므로 OpenAI 호환 공급자에 Claude ID를 입력하는 것이 의도된 조합이며 서로 맞지 않는 설정이 아닙니다.
- Models 행에서 Fetch를 누릅니다. ChatWise 문서에 따르면 API가
/models엔드포인트를 지원하면 사용 가능한 모델을 자동으로 추가할 수 있습니다. Kunavo는GET /v1/models에 응답하므로 목록이 자동으로 채워집니다. 직접 입력하려는 ID가 있다면 + New를 사용하면 됩니다. - 모델을 직접 추가하는 경우 문서에 필드가 설명되어 있습니다. Model ID는 API 식별자이고 Display Name은 라벨일 뿐이므로 ID는 카탈로그와 정확히 일치해야 합니다. Capabilities를 선택하고 Context length를 모델에 맞게 설정하세요. 이 플래그는 클라이언트에 제공할 옵션을 알려줄 뿐, 엔드포인트의 동작을 제어하지 않습니다.
- 모델 선택기에서 공급자를 선택하고 메시지를 보냅니다. 이미지 모델의 경우 ChatWise 이미지 생성 페이지에서 안내하는 단계가 하나 더 있습니다. 이미지 선택기에 표시되도록 모델 유형을 Image로 설정해야 합니다.
ChatWise 사용자 지정 공급자 페이지에서 확인했습니다(2026년 9월 21일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.
클라이언트를 디버깅하기 전에 확인할 사항
한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 ChatWise에서 작동합니다.
# 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 입력/출력 | ChatWise에서의 위치 |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | 일상적인 대화. 달러당 품질이 중요한 긴 대화 |
claude-opus-5 | $3.50 / $17.50 | 두 번째 앱을 열어야 해결할 수 있는 어려운 질문 |
claude-haiku-4-5 | $0.70 / $3.50 | 제목, 요약 및 채팅 클라이언트가 자체적으로 수행하는 백그라운드 호출 |
gpt-5-6-terra | $0.70 / $4.20 | 컨텍스트 창의 크기가 제약이 되는 긴 문서 |
gpt-5-6-sol | $2.00 / $12.00 | 동일한 키를 사용하는 다른 모델 계열의 2차 의견 |
자주 묻는 질문
ChatWise에 사용자 지정 API 공급자를 추가하려면 어떻게 하나요?
Settings를 열고 Providers로 이동한 뒤 “+”를 클릭해 새 공급자를 추가합니다. 그런 다음 프리셋을 선택하거나 사용자 지정 구성을 만듭니다. Provider name, API Base URL, API Key를 입력하고 Fetch 버튼이나 “+ New”로 모델을 추가합니다. ChatWise의 사용자 지정 공급자 문서에서는 OpenAI 호환 또는 Anthropic 호환 AI 서비스를 통합하는 방법으로 설명하므로, 게이트웨이도 우회 방법이 아닌 정식 사용 사례입니다.
ChatWise API Base URL 끝에 /v1을 붙여야 하나요?
OpenAI 호환 엔드포인트라면 그렇습니다. ChatWise는 필드 아래에 URL에 /chat/completions를 포함하지 말라는 규칙을 표시합니다. 클라이언트가 경로를 자체적으로 덧붙이므로 값은 /v1 루트여야 합니다. 즉, https://api.kunavo.com/v1을 입력합니다. ChatWise가 해당 필드에 값이 입력된 상태로 문서에 보여 주는 유일한 호스팅 게이트웨이도 https://aihubmix.com/v1로 같은 형식입니다. /v1을 생략하면 인증 실패가 아니라 404가 발생하며, 이것이 두 오류를 구분하는 가장 빠른 방법입니다.
ChatWise에서 Fetch를 눌러도 모델이 표시되지 않는 이유는 무엇인가요?
모델 목록은 입력한 키를 사용해 엔드포인트의 /models 경로에서 가져옵니다. 따라서 결과가 비어 있다면 대개 카탈로그가 비어 있는 것이 아니라 키나 기본 URL에 문제가 있습니다. 앱 외부에서 /v1/models에 일반 curl 요청을 보내 같은 조합을 테스트하세요. JSON이 반환되면 공급자 양식의 문제이고, 401이면 키 문제이며, 404이면 URL 문제입니다. 대신 “+ New”로 모델을 직접 추가할 수도 있습니다. 이때 Model ID는 카탈로그 ID와 정확히 일치해야 합니다.
ChatWise에서 자체 API 키를 사용하려면 구독이나 라이선스가 필요한가요?
두 가지 별도의 결제 관계입니다. ChatWise는 한 번 구매하는 클라이언트이며, 모델 이용 요금은 키를 발급한 곳에서 청구합니다. Kunavo 키를 사용하는 경우 토큰 사용량에 따라 선불 잔액이 차감되며 별도의 월 요금은 없습니다. 공급자 구성은 유료 등급의 잠금 해제 기능 목록에 포함되어 있지 않습니다. 다만 무료 등급에서 사용자 지정 공급자를 추가할 수 있다고 명시한 ChatWise 페이지도 없으므로, 체험판에서 사용 가능 여부를 확인한 뒤 이용을 결정하세요.
Anthropic 계정 없이 ChatWise에서 Claude 모델을 사용할 수 있나요?
OpenAI 호환 공급자 항목을 통해 사용할 수 있습니다. 모델 ID는 ChatWise 내부가 아닌 설정된 엔드포인트에서 확인되므로, 보유한 자격 증명은 해당 엔드포인트의 것입니다. ChatWise가 홍보하는 앱 내 기존 구독 로그인과는 다른 경로입니다. 기존 구독 로그인은 다른 공급자의 약관에 따르지만, 본인에게 청구되는 키는 그렇지 않습니다. Kunavo는 ChatWise를 사용해 엔드포인트를 실행해 본 적이 없으므로 이 페이지는 테스트 결과가 아닌 설정 안내로 봐야 합니다.