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

Open WebUI에서 XHuoAPI 사용하기

Open WebUI는 여러 OpenAI 호환 연결을 동시에 둘 수 있습니다. XHuoAPI로 향하는 연결을 추가하면 사용 가능한 모든 모델이 모델 선택기에 나타납니다.

시작하기 전에

콘솔에서 가입하고 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"}]}'

설정 단계

관리자로 로그인해 Admin Settings → Connections의 OpenAI 행에서 렌치 아이콘(Manage)을 클릭합니다.

Add New Connection을 클릭하고 Connection Type을 External로 설정한 뒤 URL과 API Key를 입력합니다:

URL:      https://api.xhuoapi.ai/v1
API Key:  sk-...

Model IDs는 비워 두면 됩니다. Open WebUI가 /models로 모든 모델을 자동으로 가져옵니다. 일부만 노출하려면 입력하세요(허용 목록으로 동작).

Docker로 배포한 경우 환경 변수로도 같은 설정을 할 수 있습니다:

OPENAI_API_BASE_URL=https://api.xhuoapi.ai/v1
OPENAI_API_KEY=sk-...
ENABLE_OPENAI_API=true

주의 사항

다른 연결에 같은 모델 이름이 있으면(예: 양쪽 모두 qwen3.8-max) 연결 설정에서 Prefix ID를 지정하세요. 모델이 접두어/모델명 형태로 구분 표시됩니다.

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

자주 사용하는 모델

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

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

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