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

Cherry Studio에서 XHuoAPI 사용하기

Cherry Studio는 게이트웨이형 공급자를 더 내장하지 않겠다고 밝혔으며 '사용자 지정 공급자'로 추가합니다. 설정은 내장 OpenAI와 같습니다.

시작하기 전에

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

설정 단계

설정 → 모델 서비스에서 하단의 + 추가를 클릭합니다. 이름은 자유롭게, 공급자 유형은 OpenAI를 선택합니다.

API 키와 API 주소를 입력합니다. Cherry Studio가 /v1/chat/completions를 자동으로 붙이므로 주소는 도메인만 입력합니다.

API 地址 / API address:  https://api.xhuoapi.ai
API 密钥 / API key:      sk-...

'모델 목록 가져오기'를 클릭하고 팝업의 모델 관리에서 사용할 모델 오른쪽의 +를 눌러 추가합니다. 추가한 모델만 앱 전체 선택기에 나타납니다. 마지막으로 오른쪽 위 활성화 스위치를 켭니다.

주의 사항

주소가 #으로 끝나면 Cherry Studio는 경로를 자동으로 붙이지 않고 입력한 주소를 그대로 사용합니다. 상류 경로가 표준 /v1/chat/completions가 아닐 때만 필요합니다.

모델 이름 아래에 상류가 반환한 실제 ID가 표시됩니다. 이름이 비슷한 버전은 합쳐지지 않으니 추가 전에 ID를 확인하세요.

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

자주 사용하는 모델

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

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

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