러시아의 n8n: AI 워크플로, 오류 및 비용
BetterToken을 n8n에 연결하고 AI 워크플로를 실행하며 재시도를 제한하고, 각 실행을 Dashboard의 토큰과 청구 내역에 대조합니다.
제어 가능한 한 번의 요청으로 n8n AI 워크플로를 테스트하고 싶으신가요? BetterToken n8n 가이드를 열고 자신의 API Key를 만든 다음 n8n에 OpenAI credential을 추가하세요. Manual Trigger, AI Agent, OpenAI Chat Model을 연결하고 Max Retries를 제한한 뒤, 수동 실행을 모델, 상태, 토큰 사용량, BetterToken Dashboard의 청구 내역과 대조합니다.
이 AI 과정에서 n8n이 하는 일
n8n은 노드의 순서를 관리하고 실행 데이터를 저장합니다. OpenAI Chat Model은 선택한 모델에 요청을 보내고, BetterToken은 OpenAI 호환 API 호출을 받습니다. 첫 테스트에는 세 가지 구성 요소면 충분합니다.
Manual Trigger는 일정이나 webhook으로 인한 의도치 않은 실행을 막습니다. AI Agent는 고정 prompt를 받고, Chat Model은 모델에 한 번의 요청을 보냅니다. Telegram, 이메일, 데이터베이스, 게시 또는 외부 부작용이 있는 다른 노드는 추가하지 마세요.
이 구성에서 BetterToken은 API Key, Base URL, 사용 가능한 Model ID, Dashboard의 사용 기록을 제공합니다. 모든 커뮤니티 노드나 OpenAI 호스팅 도구와의 호환성을 보장하지는 않습니다. 러시아에서 BetterToken API Endpoint에 연결할 때 VPN은 필요하지 않지만, n8n Cloud, 자체 서버, 타사 통합의 사용 가능 여부는 별도로 확인해야 합니다.
API Key를 노출하지 않고 credential 만들기
- 워크플로에 AI Agent 노드를 추가합니다.
- Chat Model 커넥터에서 OpenAI Chat Model 서브노드를 추가합니다.
- Credential to connect with 필드에서 Create new credential → OpenAI를 선택합니다.
- 화면에 **OpenAI Account (ChatGPT)**와 API Key가 보이면 API Key를 선택합니다.
credential을 다음과 같이 입력합니다.
- API Key: 본인의 BetterToken API Key.
- Organization ID: 비워 둡니다.
- Base URL:
https://www.bettertoken.ai/v1. - Add Custom Header: 끕니다.
credential은 n8n의 안전한 저장소에 저장하세요. 키를 prompt, 워크플로 JSON, Code node, 스크린샷, 실행 데이터 또는 저장소에 넣으면 안 됩니다.
현재 필드와 인증 방식은 n8n의 OpenAI credential 공식 문서에서 확인하세요.
Base URL은 /v1로 끝나야 합니다. /models, /chat/completions, /responses를 덧붙이지 마세요. n8n이 경로를 직접 완성합니다. credential을 저장할 때 n8n은 지정한 Base URL을 기준으로 /models를 통해 모델을 확인합니다.
모델 목록이 나타나지 않으면 credential과 OpenAI Chat Model을 다시 여세요. 정확한 Model ID는 최신 BetterToken n8n 문서 또는 모델 카탈로그에서 가져오며, 이 문서에서는 동적으로 바뀌는 ID를 고정하지 않습니다.
최소 AI 워크플로 만들기
1. Manual Trigger 추가하기
새 워크플로를 만들고 Manual Trigger를 추가합니다. 테스트 중에는 워크플로를 게시하지 마세요. n8n은 워크플로를 만들고 테스트할 때 수동 실행을 권장합니다.
2. AI Agent 설정하기
Manual Trigger를 AI Agent에 연결합니다. prompt 옵션에서 고정 텍스트를 입력할 수 있는 항목을 선택하고 다음을 사용합니다.
Tool nodes는 연결하지 마세요. 이 테스트에는 모델의 응답이 필요하며, 에이전트 자동화가 필요한 것이 아닙니다.
3. OpenAI Chat Model 연결하기
OpenAI Chat Model 서브노드에서 다음을 설정합니다.
- 만든 BetterToken credential을 선택합니다.
- 정확한 Model ID를 선택합니다.
- 첫 요청에서는 Use Responses API를 끄고 Chat Completions를 사용합니다.
- 최종 Timeout을 설정합니다.
- Max Retries는 현재 n8n 버전에서 허용하는 최솟값으로 설정합니다.
Model, Use Responses API, Timeout, Max Retries 파라미터는 OpenAI Chat Model 공식 페이지에 설명되어 있습니다.
Responses API와 내장 Web Search, File Search, Code Interpreter는 이 테스트에 포함하지 않습니다. n8n 화면에 표시된다고 해서 선택한 모델이나 endpoint가 이를 지원한다는 뜻은 아닙니다.
4. 수동 실행을 정확히 한 번 수행하기
Execute Workflow를 클릭합니다. 성공한 결과에는 workflow: "n8n" 및 sum: 4가 포함된 JSON이 있어야 합니다. 노드가 오류를 반환하더라도 즉시 다시 시작하지 말고, 먼저 오류 유형을 분류하세요.
실행 로그를 확인할 위치
현재 워크플로의 Executions를 열고 수동 실행을 선택합니다. 다음을 확인합니다.
- 전체 실행 상태.
- 시작 시각과 소요 시간.
- AI Agent의 입력과 출력.
- 프로세스가 멈춘 노드.
- credential이나 민감한 prompt를 복사하지 않은 오류 텍스트.
n8n은 수동 실행과 프로덕션 실행을 구분합니다. 수동 실행은 편집기에서 시작하며 테스트에 적합합니다. 프로덕션 실행은 워크플로 게시 후 또는 trigger에 의해 자동으로 시작합니다. provider를 확인하기 전까지 워크플로는 게시하지 않은 상태로 두세요.
실행 유형과 실행 목록의 차이는 n8n Executions 문서에 나와 있습니다.
실행 데이터에는 노드의 입력과 출력이 포함될 수 있습니다. 민감한 워크플로에는 n8n의 redaction을 사용할 수 있으며, 상태, 시각, 노드 이름 같은 메타데이터는 남긴 채 데이터를 숨깁니다. 이 안내의 prompt에는 개인 데이터나 비밀 정보가 없습니다.
재시도를 제한하고 오류 진단하기
자동 재시도는 일시적인 오류에만 유용합니다. 추가 API 요청을 만들기 때문에 비용에 영향을 주고 하나의 실행과 대조하기도 어려워집니다.
401/ Unauthorized: 자동으로 반복하지 말고 API Key와 불필요한 공백부터 확인합니다.403: 자동으로 반복하지 말고 선택한 모델에 대한 키의 접근 권한을 확인합니다.404/ model not found: 자동으로 반복하지 말고 Base URL과 정확한 Model ID를 확인합니다.429: 잠시 기다린 뒤 제한된 횟수만 반복하고, rate limit 및 병렬 실행 수를 확인합니다.5xx/ timeout: 정한 한도를 넘지 말고 provider 상태, Timeout, prompt 크기를 확인합니다.- Workflow error: 진단 전에는 반복하지 말고 노드, 표현식, 입력 데이터를 확인합니다.
첫 테스트에서는 Max Retries를 최소로 유지하고 루프, Wait + retry 또는 새 API 호출을 하는 error workflow를 추가하지 마세요. 나중에 프로덕션에서 retry가 필요하다면 유한한 시도 횟수와 지연 시간을 정한 뒤 Dashboard에 몇 건의 요청이 나타났는지 확인합니다.
n8n error workflow는 실패 알림에 유용하지만, 알림 자체도 외부 부작용입니다. 별도로 검증한 뒤 자체 한도를 두고 추가하세요.
Error Trigger의 동작과 실패한 실행 데이터의 구성은 공식 오류 처리 안내에 설명되어 있습니다.
Dashboard에서 토큰과 금액 확인하기
수동 실행 직후 BetterToken Dashboard를 엽니다. 다음을 대조합니다.
- n8n에서 좁힌 시작 시각과 Dashboard의 요청 시각.
- OpenAI Chat Model의 Model ID와 사용 기록의 모델.
- 성공 또는 오류 상태.
- input, output, 해당되는 cache Token.
- 해당 기록에 연결된 청구 금액.
오래된 글이나 100만 Token당 고정된 숫자로 금액을 계산하지 마세요. 모델과 가격은 바뀌므로 한 번의 호출에 대한 실제 청구는 Dashboard에서, 현재 요금은 BetterToken 가격 페이지에서 확인합니다.
한 번의 수동 실행이 Dashboard의 여러 줄과 일치하면 Max Retries와 Agent 동작을 확인합니다. 화면에서는 하나의 워크플로 실행으로 보여도, 특히 Agent loop나 Responses tools를 쓰면 여러 모델 요청이 발생할 수 있습니다. 따라서 첫 확인은 고정 prompt, 도구 없음, 최소 반복으로 수행합니다.
자주 발생하는 오류
credential 테스트가 401을 반환함
OpenAI 유형 credential을 다시 만들고 API Key 주변의 공백을 없앤 다음 OpenAI Account가 아니라 API Key 모드가 선택되었는지 확인합니다. 실행 로그에 키를 표시하지 마세요.
credential 테스트 또는 노드가 404를 반환함
Base URL은 https://www.bettertoken.ai/v1이어야 합니다. /models나 endpoint를 추가하지 마세요. 그다음 모델 목록을 다시 불러오고 현재 ID를 선택합니다.
일반 Chat은 작동하지만 Agent tools는 작동하지 않음
최소 워크플로로 돌아갑니다. Use Responses API를 끄고 Tool nodes를 제거한 뒤 고정 prompt를 한 번 반복합니다. 이렇게 하면 provider 연결과 특정 도구 또는 워크플로의 제약을 분리할 수 있습니다.
실행은 성공했지만 Dashboard에 여러 요청이 표시됨
Max Retries와 Agent loop를 확인합니다. 시각과 상태를 비교하세요. n8n이 실제로 여러 요청을 보냈다면 각 줄을 하나의 호출로 간주해 수동으로 합산하지 마세요.
자주 묻는 질문
확인하려면 워크플로를 게시해야 하나요?
아니요. 편집기에서 수동 실행하면 충분합니다. 게시하면 프로덕션 trigger가 활성화되어 추가 확인 없이 외부 작업이 시작될 수 있습니다.
Responses API를 사용할 수 있나요?
선택한 모델과 endpoint를 별도로 확인한 후에만 가능합니다. 첫 연결에는 내장 OpenAI tools 없이 일반 Chat Completions를 사용하세요.
BetterToken API Key는 어디에 저장되나요?
n8n의 OpenAI 유형 credential에 저장됩니다. 노드 파라미터, 워크플로 JSON, prompt, 저장소에 복제하지 마세요.
워크플로의 실제 비용은 어떻게 알 수 있나요?
최소 retries로 수동 실행한 뒤 실행 시각, Model ID, 상태를 BetterToken Dashboard의 기록과 대조합니다. 추정 예시가 아니라 그 기록의 Token과 사용량을 사용하세요.