전체 가이드 / 워크플로 자동화

n8n에서 XHuoAPI 사용하기

n8n 1.73.0부터 Base URL이 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"}]}'

설정 단계

왼쪽 Credentials → Add credential → OpenAI를 검색해 OpenAI API를 선택합니다.

API Key를 입력하고 Base URL을 아래 주소로 바꾼 뒤 저장합니다.

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

OpenAI Chat Model 노드 또는 AI Agent 노드에서 이 자격 증명을 선택합니다. Model 항목에 모델 ID(예: deepseek-v3.2)를 직접 입력하세요. 드롭다운에 모두 나오지 않을 수 있습니다.

주의 사항

n8n 1.73.0 이전 버전은 자격 증명에 Base URL 필드가 없습니다. 그 경우 각 노드의 Options → Base URL에 같은 주소를 노드마다 입력하세요.

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

자주 사용하는 모델

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

deepseek-v3.2 gpt-5.4-mini gemini-3.7-flash claude-sonnet-5 glm-5.3

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