주요 설정
사전 요구 사항
추가 요구 사항
- n8n Cloud 또는 self-hosted instance
Base URL 끝의
/v1를 유지하세요. /chat/completions 또는 /responses를 추가하지 마세요. n8n이 node에 필요한 route를 추가합니다.설치
n8n을 설치하거나 연 다음 아래의 수동 설정을 계속하세요.수동 설정
n8n node configuration UI에서 이 설정을 완료하세요. n8n configuration file을 직접 수정할 필요가 없습니다.설정
1
AI Agent와 OpenAI Chat Model 추가
workflow를 열고 AI Agent node를 추가하세요. 해당 Chat Model connector에서 OpenAI Chat Model sub-node를 추가하세요.이 가이드에서는 n8n AI Agents, chains 및 기타 AI workflows에 model connection을 제공하는 OpenAI Chat Model을 사용합니다.
2
OpenAI credential 만들기
OpenAI Chat Model에서 Credential to connect with를 열고 Create new credential을 선택한 다음 OpenAI를 선택하세요.n8n version에서 **OpenAI Account (ChatGPT)**와 API Key를 모두 제공한다면 API Key를 선택하세요. OpenAI Account authentication은 official account용이며 BetterToken custom Base URL용이 아닙니다.
3
BetterToken credential 입력
다음 값을 사용하세요.
Save를 클릭하세요. n8n은 설정한 Base URL 아래의
/models로 이 credential을 테스트하므로 전체 test URL은 https://www.bettertoken.ai/v1/models입니다.4
모델 선택
OpenAI Chat Model로 돌아가 Model을 열고 모델 광장에 표시된 지원되는 provider의 model ID를 선택하세요.credential을 저장한 후 list가 업데이트되지 않으면 node 또는 credential을 다시 열고 model list를 다시 로드하세요.
5
Chat Completions 또는 Responses 선택
첫 번째 test에서는 Use Responses API를 끈 채 기본 Chat Completions mode로 일반 conversation을 완료하세요.workflow에 필요할 때만 Use Responses API를 켜세요. n8n은 Responses가 활성화된 OpenAI Chat Model + AI Agent에서 Web Search, File Search, Code Interpreter 등의 built-in tools를 문서화합니다. 이러한 OpenAI-hosted tools가 BetterToken에서 자동으로 확인된 capabilities인 것은 아니므로 선택한 model과 endpoint로 테스트하세요.
6
테스트 실행
AI Agent에 간단한 input을 제공하세요.Execute step을 클릭하거나 workflow를 실행하세요. node가 model response를 반환하면 설정이 완료됩니다.
연결 확인
짧은 테스트 prompt를 보내세요. 도구가 authentication 또는 Model ID 오류 없이 response를 반환하면 연결이 작동합니다. configuration을 변경한 후에는 도구를 완전히 다시 시작하세요.모델 전환
model selector를 열거나 configuration의Model field를 변경하세요. 모델 광장의 정확한 Model ID를 사용한 다음 현재 session을 다시 시작하세요.
일반적인 오류
Credential test가 401을 반환함
- API Key가 완전하며 extra spaces가 없는지 확인하세요.
- key가 지원되는 provider의 Model ID를 사용하는지 확인하세요.
- BetterToken Dashboard에서 key status와 balance를 확인하세요.
Credential test가 404를 반환함
- Base URL은
https://www.bettertoken.ai/v1이어야 합니다. https://www.bettertoken.ai/v1/models를 Base URL로 사용하지 마세요./chat/completions또는/responses를 추가하지 마세요.
Model list가 비어 있음
- credential을 다시 저장한 다음 Model을 다시 여세요.
- API Key가
https://www.bettertoken.ai/v1/models에 access할 수 있는지 확인하세요. - 모델 광장에서 현재 model ID를 복사하세요. retired 또는 misspelled ID를 사용하지 마세요.
일반 chat은 작동하지만 Agent tool calls가 실패함
Use Responses API와 모든 built-in tools를 끈 다음 일반 Chat Completions를 확인하세요. 문제가 model capability, tool arguments 또는 workflow configuration인지 파악하도록 Agent tools를 하나씩 활성화하세요.request가 timeout됨
OpenAI Chat Model > Options 아래의 Timeout을 늘리고 Max Retries 값은 제한하세요.400, 401 또는 configuration errors를 반복해서 retry하지 마세요.
고급 설정
지원 Provider
표시된 상태는 이 페이지에서 설명하는 BetterToken 설정 방식에 적용됩니다.
설정 방식 설명
설정 방식 설명
- 수동 설정: API Key, Base URL, Model을 입력하세요.
- 지원되지 않음: 검증된 직접 연결 방식이 아직 없습니다.
관련 가이드
- n8n OpenAI credentials
- n8n OpenAI Chat Model
- OpenAI-compatible API와 Anthropic-compatible API 비교
- 모델 선택 방법
기술 세부 정보
Protocol, endpoint 및 내부 provider 필드
Protocol, endpoint 및 내부 provider 필드
이 설정은
https://www.bettertoken.ai/v1을 사용합니다. 도구가 OpenAI-compatible endpoint path를 추가합니다. 특정 field에서 명시적으로 요구하지 않는 한 /chat/completions 또는 /responses를 추가하지 마세요.