n8n

페어코드 워크플로우 자동화 도구로 네이티브 AI 노드와 400개 이상의 통합 지원

소개

n8n은 AI 노드를 네이티브로 지원하는 워크플로우 자동화 플랫폼입니다. OpenAI 통합에서 커스텀 Base URL을 지원하므로 TokenMix의 OpenAI 호환 엔드포인트를 지정하면 n8n의 모든 AI 노드에서 TokenMix 모델을 사용할 수 있습니다.

사전 조건

Docker로 n8n을 셀프호스트합니다(권장):

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

http://localhost:5678에 접속하여 초기 설정을 완료합니다.

TokenMix API 키도 필요합니다. tokenmix.ai → 콘솔 → API Keys에서 생성하세요.

설정 단계

1단계 — 자격 증명 열기

n8n 사이드바에서 자격 증명 → 자격 증명 추가 → OpenAI 검색.

2단계 — OpenAI 자격 증명 입력

필드	값
API 키	TokenMix 키(`sk-tm-…`)
Base URL	`https://api.tokenmix.ai/v1`
조직 ID	비워 두기

저장을 클릭하면 n8n이 자동으로 테스트합니다.

3단계 — AI 노드에서 사용

워크플로우에 AI Agent, LLM Chain 등의 노드를 추가하고, 방금 만든 자격 증명을 선택한 후 모델 이름(예: gpt-5.4, claude-sonnet-4.6, deepseek-v4-pro)을 입력합니다.

4단계 — 실행 및 검증

워크플로우를 실행하고 노드 출력을 확인합니다. TokenMix 콘솔 → 사용 기록에서도 요청이 기록되었는지 확인하세요.

검증

워크플로우 테스트 버튼으로 수동 실행합니다. 노드 출력이 정상이면 TokenMix 라우팅이 성공한 것입니다.

자주 묻는 질문

Q: OpenAI 노드에서 404 "model not found" 오류가 발생합니다. A: 모델 이름이 TokenMix 모델 페이지의 short_id와 정확히 일치하는지 확인하세요(예: gpt-5가 아닌 gpt-5.4). n8n v2 AI 노드는 노드 설정의 모델 이름을 그대로 사용합니다.

Q: 구버전 n8n에서 Base URL 필드가 없습니다. A: n8n을 최신 버전으로 업데이트하세요. 또는 HTTP Request 노드를 사용해 https://api.tokenmix.ai/v1/chat/completions를 직접 호출하고 Authorization: Bearer sk-tm-xxx 헤더를 추가하세요. 모든 n8n 버전에서 작동합니다.

Q: 워크플로우마다 다른 모델을 사용할 수 있나요? A: 가능합니다. 자격 증명은 공통(같은 Base URL과 API 키)으로 사용하고, 각 노드 설정에서 모델 이름만 변경하면 됩니다.