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

LobeChat에서 XHuoAPI 사용하기

셀프 호스팅 LobeChat은 환경 변수 두 개로 OpenAI 호환 엔드포인트에 연결합니다. OPENAI_PROXY_URL로 주소, OPENAI_API_KEY로 키를 지정합니다.

시작하기 전에

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

설정 단계

.env 또는 docker-compose의 environment에 다음을 설정합니다:

OPENAI_API_KEY=sk-...
OPENAI_PROXY_URL=https://api.xhuoapi.ai/v1

컨테이너를 재시작합니다. LobeChat의 설정 → 언어 모델 → OpenAI를 열면 XHuoAPI 모델이 보여야 합니다. 없으면 '모델 목록 가져오기'를 클릭하세요.

주의 사항

LobeChat 문서가 특별히 언급하는 점: /v1 필요 여부는 상류에 따라 다릅니다. XHuoAPI는 /v1이 필요합니다. 채팅 응답이 비어 있으면 먼저 이 부분을 확인하세요.

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

자주 사용하는 모델

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

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

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