n8n
n8n의 OpenAI 자격 증명은 사용자 지정 기본 URL을 받을 수 있습니다. 한 번만 설정해 두면 AI Agent, Basic LLM Chain 등의 노드에서 NezhaGate 모델을 쓸 수 있습니다.
1. OpenAI 자격 증명 만들기
- Credentials → Add credential → OpenAI.
- API Key에 NezhaGate 키를, Base URL에
https://nezhagate.com/v1을 입력하세요. Organization ID는 비워 두세요. - 저장하세요. n8n이 연결을 테스트하려고 모델 목록을 한 번 읽는데, 이때는 과금되지 않습니다.
Base URL
https://nezhagate.com/v12. OpenAI Chat Model 노드에서 모델 고르기
- Model → From List를 선택하면 NezhaGate의 모든 모델이 나열되므로 그중 채팅 모델을 고르세요. 또는 ID를 선택해
gpt-5.5처럼 직접 입력할 수도 있습니다. - Use Responses API는 기본으로 켜져 있으며 요청을
/v1/responses로 보내는데, NezhaGate는 이 엔드포인트에서 GPT 모델만 제공합니다. 다른 모델을 쓸 때는 꺼야 하고, GPT 모델이라면 켜든 꺼든 상관없습니다. - Built-in Tools(Web Search, File Search, Code Interpreter)는 꺼진 상태로 두세요. OpenAI가 직접 호스팅하는 기능입니다.
- OpenAI 앱 노드의 Message a Model 작업은 항상
/v1/responses를 사용하므로 GPT 모델에서만 동작합니다. 다른 모델에는 OpenAI Chat Model 노드를 쓰세요.
Claude(선택 사항)
Base URL에 https://nezhagate.com/anthropic을 넣고 같은 API 키로 Anthropic 자격 증명을 만든 뒤, Anthropic Chat Model 노드에서 Claude 모델을 고르세요.
테스트
Chat Trigger → AI Agent → OpenAI Chat Model로 이어지는 워크플로를 만들고 Open chat을 클릭해 메시지를 보내 보세요.
자주 나오는 오류
자격 증명 테스트가 실패할 때
404는 기본 URL에 /v1이 빠졌거나 잘못된 것입니다(https://nezhagate.com/v1이어야 합니다). 401은 키가 잘못된 것입니다.
특정 모델에서 400, 404, 503이 반환될 때
대개 GPT가 아닌 모델에서 Use Responses API가 켜져 있는 경우입니다. 꺼 보세요.
에이전트가 도구를 호출하지 않거나 JSON 출력이 적용되지 않을 때
모든 모델이 도구 호출이나 JSON 출력을 지원하지는 않습니다. 지원하는 모델을 고르세요(각 모델의 API 문서 참고).
