# n8n

n8n의 OpenAI 자격 증명은 사용자 지정 기본 URL을 받을 수 있습니다. 한 번만 설정해 두면 AI Agent, Basic LLM Chain 등의 노드에서 NezhaGate 모델을 쓸 수 있습니다.

> https://nezhagate.com/ko/docs/integrations/n8n

작성 기준 버전: n8n 2.42

## 1. OpenAI 자격 증명 만들기

1. **Credentials** → **Add credential** → **OpenAI**.

2. **API Key**에 NezhaGate 키를, **Base URL**에 `https://nezhagate.com/v1`을 입력하세요. Organization ID는 비워 두세요.

3. 저장하세요. n8n이 연결을 테스트하려고 모델 목록을 한 번 읽는데, 이때는 과금되지 않습니다.

Base URL`https://nezhagate.com/v1`

## 2. 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 문서 참고).