n8n 인증 테스트는 통과하는데 404가 난다면 요청 경로 확인하기

n8n OpenAI 인증 테스트가 성공해도 워크플로의 생성 엔드포인트가 지원된다는 뜻은 아닙니다. 인증은 모델 목록 경로를 시험하고 생성은 다른 경로를 쓸 수 있습니다. 제공자가 /models는 받지만 선택한 /responses를 지원하지 않으면 인증은 통과해도 실행은 실패할 수 있습니다.

이 글은 OpenAI 자격 증명, OpenAI 작업 노드, OpenAI Chat Model 하위 노드를 구분합니다. 모든 n8n 버전의 기본값이 같다고 가정하지 않고 특정 버전 소스를 근거로 설명합니다. 기존 중국어 글에는 과거 로컬 시험이 기록돼 있지만 이 글은 그 결과를 새 운영 환경 테스트로 제시하지 않습니다.

Base URL은 자격 증명에 설정하기

OpenAI 자격 증명에는 Base URL 필드가 있습니다. 호환 노드를 다른 API 루트로 연결하는 설정입니다. 특정 채팅이나 응답 작업의 전체 URL 대신 제공자가 문서화한 루트를 사용하세요.

예를 들어 루트가 /v1으로 끝나면 생성 작업이 뒤에 자체 경로를 붙입니다. 루트를 기대하는 필드에 /chat/completions까지 넣으면 노드가 다시 경로를 붙여 잘못된 URL이 될 수 있습니다. 실제 오류는 제공자에 따라 다르므로 404만으로 원인을 확정할 수 없습니다.

고정 버전의 n8n 2.36.9 자격 증명 소스는 Base URL 필드와 /models 인증 테스트를 보여 줍니다. 이 테스트는 전체 채팅 생성 요청을 보내지 않습니다.

세 가지 작업 구분하기

제공자가 모델 목록을 인증 없이 공개한다면 목록 성공은 키에 대해서도 약한 근거입니다. 모든 제공자가 그렇다고 가정하거나 생성 실패만으로 키가 잘못됐다고 판단하지 마세요. 제공자의 인증 요건과 실제 응답을 확인합니다.

어느 노드가 실패했는지 확인하기

OpenAI 작업 노드 문서는 여러 생성 작업을 나열합니다. OpenAI Chat Model은 별도의 하위 노드이며 흔히 AI Agent에 연결되고 자체 옵션을 가집니다. 한쪽의 안내를 다른 쪽에 그대로 적용하지 마세요.

n8n 2.36.9의 Chat Model 구현은 노드 typeVersion 1.3 이상에 Responses 옵션을 표시하고 UI 기본값을 true로 정의합니다. 그래도 저장된 워크플로의 명시적 매개변수와 실행 동작을 확인해야 합니다. 특정 소스 버전의 설명이며 모든 현재 설치 환경에 대한 보장은 아닙니다.

일반 문서나 오래된 튜토리얼은 다른 기본값을 설명할 수 있습니다. 문제가 생긴 노드를 내보내 type과 typeVersion을 기록하고 실제 저장된 옵션을 확인하세요. 다른 릴리스의 스크린샷으로 이 근거를 대신하지 마세요.

실패한 요청 추적하기

1. n8n 버전, 노드 type, typeVersion, 작업을 기록합니다.
2. 키를 노출하지 않고 Base URL 루트와 정확한 모델 ID를 확인합니다.
3. 비밀정보를 제거한 요청 로그나 제공자 추적에서 /responses와 /chat/completions 중 실제 전송 경로를 확인합니다.
4. 정확한 모델에 대해 제공자가 지원하는 경로와 비교합니다.
5. Chat Completions 지원이 문서화돼 있다면 그 작업을 선택하거나 Chat Model 옵션을 조정한 뒤 실제 경로를 다시 확인합니다.

옵션 하나를 끄는 것이 항상 해결책은 아닙니다. 라이브러리 동작이나 다른 기능 설정이 경로 선택에 영향을 줄 수 있습니다. 합격 기준은 토글 모양이 아니라 실제 요청 경로와 응답입니다.

URL을 확인하려고 부작용이 있는 운영 워크플로를 다시 실행하지 마세요. 무해한 입력으로 모델 호출을 분리하고 메시지를 보내거나 기록을 수정하는 도구는 연결을 끊습니다. 응답을 직접 확인할 수 있을 만큼 재현 범위를 줄이세요.

지원 요청용 최소 기록

n8n version:
node type and typeVersion:
selected operation / Responses option:
provider API root:
exact model ID:
observed HTTP method and path:
HTTP status and redacted error body:
request ID, if supplied:

API 키, 인증 헤더, 비공개 워크플로 전체를 공개 이슈에 붙이지 마세요. 경로와 오류 필드는 남기되 자격 증명과 민감한 프롬프트는 제거합니다.

과거 이슈 #21651은 n8n 1.118.2에서 외부 제공자의 인증 테스트는 성공했지만 실행 시 404가 발생했다고 보고합니다. 이 증상이 실제 보고됐음을 보여 주지만 같은 과거 버그가 현재 버전에도 남아 있다는 증거는 아닙니다.

첫 설명에서 조사를 멈추지 않기

404는 잘못된 모델 ID, 제공자 고유 경로, 추가 경로 구간, 리버스 프록시에서도 발생할 수 있습니다. /chat/completions 자체가 실패한다면 응답을 보관하고 Responses 호환성만 원인이라고 결론 내리기 전에 다른 가능성을 확인하세요.

model-not-found 진단 가이드(영문)는 모델 접근과 식별자를 다룹니다. API 이전 가이드(영문)는 제공자 전환의 더 넓은 절차를 설명합니다. 어느 쪽도 지금 사용하는 정확한 엔드포인트 검증을 대신하지 않습니다.