n8n을 CheapTokens에 연결하기: OpenAI 자격 증명, Base URL

n8n에서 OpenAI 자격 증명을 만들고 Base URL 필드에 https://api.cheaptokens.dev/v1을 넣은 뒤, CheapTokens 키를 API Key에 붙여넣고 OpenAI Chat Model 노드에서 모델 id를 선택하세요. 변경은 이게 전부입니다. 커스텀 노드도, 커뮤니티 패키지도 필요 없습니다. 기존 워크플로는 노드를 그대로 유지하고 새 자격 증명만 추가하면 됩니다.

이게 되는 이유는 CheapTokens API가 OpenAI Chat Completions 형식(그리고 Anthropic Messages도)을 지원하기 때문에 n8n의 OpenAI 노드가 차이를 구분할 수 없기 때문입니다. "base URL"이라는 개념이 생소하다면 이 설명 글에서 2분이면 파악할 수 있습니다.

n8n 자격 증명에서 설정할 수 있는 것#

n8n의 OpenAI 자격 증명에는 채울 항목이 네 가지 있습니다. n8n 저장소의 자격 증명 소스 코드(master 브랜치, 2026년 11월 1일 확인)에 따르면 API Key(필수, 마스킹됨), Organization ID(선택), Base URL(기본값 https://api.openai.com/v1, 기본 API 주소를 재정의하는 것으로 설명됨), 그리고 헤더 이름과 값을 입력하는 Add Custom Header 스위치입니다.

알아둘 만한 점이 하나 있습니다. n8n의 OpenAI 자격 증명 공식 문서 페이지에는 키와 조직 ID만 나와 있습니다. Base URL 필드는 소스 코드에서 확인할 수 있으며, 이 가이드는 그것을 근거로 합니다.

저장하면 n8n이 Authorization: Bearer <API Key> 헤더와 함께 {Base URL}/models으로 요청을 보내 자격 증명을 테스트합니다. 따라서 Base URL이나 키가 잘못되면 무언가를 만들기 전에 바로 그 자리에서 드러납니다.

네 단계로 설정하기#

모델 id로 무엇을 입력해야 할지 모르겠다면 API에 직접 물어보세요. GET /v1/models로 모델 목록 조회하면 정확한 문자열을 볼 수 있습니다. 제공자마다 같은 모델을 다르게 부르므로 다른 서비스 문서가 아니라 CheapTokens에서 id를 복사하세요.

먼저 n8n 밖에서 키 확인하기#

자격 증명 테스트가 실패하면 문제가 n8n에 있는지 키에 있는지 알고 싶을 겁니다. 짧은 터미널 확인으로 답을 얻을 수 있습니다. 키는 환경 변수에 있으므로 비밀 정보가 히스토리에 남지 않습니다.

export CHEAPTOKENS_API_KEY="your-key-here"
curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY"

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
r = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Reply with one word: ready"}],
    max_tokens=20,
)
print(r.choices[0].message.content, r.usage)

첫 워크플로: 들어오는 이메일 분류하기#

공유 받은 편지함에 하루 약 천 통의 이메일이 온다고 해봅시다. 모든 이메일에 billing, bug, other 태그를 붙이고, 담당자가 볼 수 있게 한 줄 요약도 달고 싶습니다.

이렇게 만드세요. Gmail Trigger(또는 Webhook 노드)가 Basic LLM Chain으로 이어집니다. 체인의 프롬프트는 "이 이메일을 billing, bug, other로 분류하고 한 문장으로 요약하라" 같은 내용이며, 이메일 본문은 이전 노드에서 삽입합니다. 그 아래 OpenAI Chat Model 노드가 CheapTokens 자격 증명으로 실제 처리를 합니다.

이 작업은 짧고 반복적입니다. 작은 입력, 작은 답변, 수천 번의 동일한 실행. 바로 이런 곳에서 가격이 안정적인 저렴한 모델이 가장 큰 효과를 냅니다. CheapTokens에서 이런 작업에는 DeepSeek-V4-Flash가 하루 중 언제든 동일한 가격, 380K 컨텍스트 윈도우, 답변당 최대 32,768 토큰을 제공합니다.

실행 한 번의 비용#

이메일마다 프롬프트가 약 1,500 토큰(지시문과 이메일)이고 모델이 약 300 토큰을 쓴다고 해봅시다. DeepSeek-V4-Flash에서 한 번 실행하면 $0.000053입니다. 하루 1,000통 기준으로 OpenRouter와 입력·출력을 합산해 모든 모델을 나란히 비교하면 다음과 같습니다.

토큰 수는 이 예시를 위한 가정입니다. Python 확인으로 일반적인 이메일을 보내고 usage을 읽어 직접 측정한 뒤 숫자를 바꾸세요. 현재 가격은 가격 페이지에 있습니다.

채팅형 워크플로는 다릅니다. 메모리 노드를 쓰면 매 호출마다 전체 히스토리가 함께 전달되므로 입력이 메시지마다 커집니다. 긴 AI 채팅이 더 비싼 이유에서 얼마나 빨리 늘어나는지 볼 수 있습니다.

안 될 때#

대부분의 실패는 세 가지 중 하나입니다. 키, 주소, 모델 id. API 401 또는 404: 잘못된 키, base URL 또는 모델 id에서 각 오류 문구를 하나씩 살펴봅니다. 열기 전에 이 목록을 점검하세요.

나머지 설정도 보고 싶으신가요? CheapTokens 문서에 전체 API 레퍼런스가 있고, DeepSeek 페이지에 모델의 한도가 나와 있습니다. 같은 패턴으로 다른 도구를 이미 쓰고 계신가요? Open WebUI와 LangChain도 같은 방식으로 연결됩니다. 주소 하나, 키 하나, 모델 id 하나.