전체 가이드 / 채팅 클라이언트

Chatbox에서 XHuoAPI 사용하기

Chatbox의 사용자 지정 공급자는 /v1/chat/completions를 자동으로 붙이므로 API Host에는 도메인만 입력합니다.

시작하기 전에

콘솔에서 가입하고 API 토큰을 만듭니다. 가입에는 이메일만 필요하고 전화번호는 필요하지 않습니다.
토큰을 만들 때 티어를 선택합니다. 신규 계정의 기본값은 Standard입니다. 티어는 가격과 안정성, 사용 가능한 모델을 결정합니다. 자세한 내용은 가격 페이지를 참조하세요.

먼저 확인

도구를 설정하기 전에 curl로 키와 모델이 작동하는지 확인하세요. '설정했는데 반응이 없다'는 경우의 절반은 여기서 걸러집니다.

curl https://api.xhuoapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'

설정 단계

가장 빠른 방법: Chatbox 1.15.1부터 공급자 설정을 한 번에 가져올 수 있습니다. Chatbox가 설치되어 있으면 아래 버튼으로 API Host와 주요 모델이 자동 입력되고 API Key만 추가하면 됩니다. 딥링크를 원하지 않으면 JSON을 내려받아 수동으로 가져올 수 있습니다.

JSON: https://xhuoapi.ai/assets/chatbox-provider.json

Import into Chatbox

수동 설정: Chatbox를 열고 사이드바의 설정에서 Model Provider로 이동해 하단의 Add를 클릭합니다.

공급자 이름은 자유롭게, API 유형은 OpenAI API compatible을 선택하고 API Key와 API Host를 입력합니다. API Path는 비워 두면 기본값 /v1/chat/completions가 적용됩니다.

API Host:  https://api.xhuoapi.ai
API Key:   sk-...
API Path:  （留空 / leave empty）

모델을 하나 이상 ID로 추가합니다(예: deepseek-v3.2). 지원하는 기능(비전, 도구 호출)에 체크하세요. 체크하지 않으면 텍스트 전용으로 처리됩니다.

주의 사항

다른 도구와 달리 여기서는 API Host에 /v1을 붙이지 않습니다. 붙이면 /v1/v1/chat/completions로 요청이 가서 404가 반환됩니다.

Qwen 계열과 이미지/비디오 모델은 Standard와 Official 티어에서만 사용할 수 있습니다. Saver 또는 Spot 티어의 토큰으로는 '모델 사용 불가' 오류가 발생합니다.

자주 사용하는 모델

이런 도구에서 자주 선택되는 모델입니다. 모델 이름을 클릭하면 티어별 가격을 볼 수 있습니다. 전체 목록은 가격 페이지에 있습니다.

deepseek-v3.2 qwen3.8-max gemini-3.7-flash claude-sonnet-5 gpt-5.4-mini

단계는 해당 도구의 현재 공식 문서를 기준으로 정리했습니다. 업데이트 후 UI가 바뀔 수 있습니다. 다른 점이 있으면 알려 주세요.