전체 가이드 / 코딩 어시스턴트

Cursor에서 XHuoAPI 사용하기

Cursor는 자체 API 키를 사용하고 OpenAI 형식 요청을 OpenAI 호환 엔드포인트로 보낼 수 있습니다. 설정은 API 키, Base URL, 모델 ID 세 항목입니다.

시작하기 전에

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

설정 단계

Cmd+Shift+J(macOS) 또는 Ctrl+Shift+J(Windows/Linux)로 설정을 열고 Models 페이지에서 API Keys 섹션을 찾습니다.

OpenAI API Key 항목에 XHuoAPI 키를 붙여 넣습니다. OpenAI 모델을 쓰지 않아도 Cursor는 이 항목으로 변경된 엔드포인트에 인증합니다.

Override OpenAI Base URL을 체크하고 나타나는 입력란에 아래 URL을 입력합니다.

https://api.xhuoapi.ai/v1

Models 목록에서 Add model을 눌러 deepseek-v4-pro 같은 모델 ID를 추가하고 채팅의 모델 선택기에서 선택합니다.

주의 사항

알려진 제한: Override를 켜면 내장 선택기에서 고른 Cursor 구독 모델을 포함해 OpenAI 계열 요청이 모두 지정 엔드포인트로 전송됩니다. 구독 모델을 쓰려면 Override를 잠시 끄세요. Cursor 팀이 현재 동작으로 확인했습니다.

Tab 자동완성은 영향을 받지 않습니다. 항상 Cursor 자체 백엔드를 사용합니다.

Base URL은 /v1까지만 입력하세요. /chat/completions를 붙이면 클라이언트가 경로를 중복으로 추가해 404가 발생합니다.

모델 ID는 가격 페이지의 표기와 정확히 일치해야 합니다(DeepSeek V4 Pro가 아니라 deepseek-v4-pro). 대소문자와 하이픈도 구분됩니다.

자주 사용하는 모델

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

deepseek-v4-pro claude-sonnet-5 gpt-6-sol kimi-k2.7-code glm-5.3

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