---
title: "n8n OpenAI 호환 Base URL 설정: OpenAI Chat Model 노드 | BroadRouter"
description: "n8n의 OpenAI 자격 증명에서 Base URL을 BroadNet Inference로 바꾸고, OpenAI Chat Model 노드에서 모델을 ID로 지정한 뒤 Responses API 토글을 끄는 방법입니다."
url: https://broadrouter.com/ko/guides/n8n-openai-compatible/
lang: ko
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

이 페이지는 영어 원문을 AI의 도움을 받아 번역했습니다. [영어 원문 읽기](https://broadrouter.com/guides/n8n-openai-compatible/) (2026-11-16 업데이트).

# n8n에서 BroadNet Inference 사용하기(OpenAI 자격 증명, Base URL)

업데이트 2026-11-16

n8n에서 API Key에는 BroadNet 키를, Base URL에는 https://inference.broadnet.ai/v1을 넣어 OpenAI 자격 증명을 만드세요. OpenAI Chat Model 노드에서 Model을 From List에서 ID로 바꾸고 broadnet/glm-5.3 같은 BroadNet ID를 입력한 뒤, n8n이 chat completions를 호출하도록 Use Responses API를 끄세요.

n8n은 워크플로 자동화 도구입니다. n8n의 **OpenAI** 자격 증명에는 **Base URL** 필드가 있어서, **OpenAI Chat Model** 노드(그리고 이 자격 증명을 쓰는 다른 OpenAI 노드)가 OpenAI 호환 API라면 어디든 호출할 수 있습니다. BroadNet Inference도 그중 하나입니다. n8n의 자격 증명 문서 페이지에는 Base URL 필드가 나오지 않으므로, 아래 필드 이름은 출처에 링크한 n8n 소스 코드와도 대조해 확인했습니다.

## 설정

1.  **자격 증명을 만듭니다.** n8n에서 **Credentials**로 가서 새 **OpenAI** 자격 증명을 만들고 다음과 같이 입력하세요.
    
    | 필드 | 값 |
    | --- | --- |
    | API Key | BroadNet 키 |
    | Organization ID (optional) | 비워 둠 |
    | Base URL | `https://inference.broadnet.ai/v1` |
    
    저장하세요. n8n은 Base URL의 `/models`를 호출해 자격 증명을 테스트합니다.
    
2.  **모델 노드를 추가합니다.** **AI Agent** 또는 **Basic LLM Chain** 노드를 추가한 다음, **OpenAI Chat Model** 하위 노드를 연결하고 자격 증명을 선택하세요.
    
3.  **모델을 ID로 지정합니다.** **Model**에서 모드를 **From List**에서 **ID**로 바꾸고 `broadnet/glm-5.3` 값을 입력하세요.
    
4.  **Use Responses API를 끕니다.** n8n 소스 코드를 보면 이 토글은 노드 버전 1.3부터 있으며, 그 버전에서는 기본으로 켜져 있습니다. BroadNet은 chat completions를 제공하므로 꺼야 합니다.
    
5.  **옵션을 설정합니다.** **Options**에서 **Maximum Number of Tokens**는 기본값(-1)으로 두거나 수천 정도로 설정하세요. **Max Retries**의 기본값은 2이며, 실패한 호출을 더 많이 재시도하게 하려면 늘리세요.
    
6.  **워크플로를 실행합니다.** 테스트 프롬프트로 한 번 돌려 보세요.
    

OpenAI가 아닌 Base URL을 쓰면 n8n은 “not all models might be chat-compatible or support tools calling or JSON response format”(번역: 모든 모델이 채팅과 호환되거나 도구 호출 또는 JSON 응답 형식을 지원하지는 않을 수 있음)이라는 안내를 표시합니다. BroadNet에서는 모든 채팅 모델에서 채팅이 작동하지만, BroadNet 문서는 도구와 구조화된 출력을 GLM 5.3과 Qwen3.8 27B에만 표기합니다.

## 어떤 모델을 고를까

| 워크플로 | 모델 | 이유 |
| --- | --- | --- |
| 도구를 쓰는 AI Agent | `broadnet/glm-5.3` | BroadNet이 도구와 구조화된 출력을 표기 |
| 이미지, 아랍어 메시지 | `broadnet/qwen3.8-27b` | 도구, 이미지 입력, 아랍어로 테스트됨 |
| 대량 분류 | `broadnet/gemma-4-26b-a4b` | 낮은 토큰당 가격, 추론 표기 없음 |
| 긴 문서 | `broadnet/deepseek-v4.1-flash` | 100만 토큰 컨텍스트, 도구 표기 없음 |

가격은 [가격 페이지](https://broadrouter.com/ko/pricing/)에서 비교하세요. 오디오는 n8n의 HTTP Request 노드로 `/v1/audio/transcriptions`에 파일을 보낼 수 있습니다. 보내야 할 폼 필드는 [아랍어 음성 인식 가이드](https://broadrouter.com/ko/guides/arabic-speech-to-text-api/)에 나와 있습니다.

## 문제 해결

-   **자격 증명 테스트 실패.** Base URL이 `/v1`로 끝나고 뒤에 다른 경로가 없는지 확인하세요. 채팅 호출도 401을 반환한다면 키가 틀렸거나 만료되었거나, 종량제 사용 가능 금액이 소진된 것입니다.
-   **모델 오류.** **ID** 모드를 쓰고 `broadnet/` 접두사를 포함한 BroadNet ID를 정확히 입력하세요. GLM 5.3, Qwen3.8 27B, DeepSeek V4.1 Flash는 충전이 필요하며, 초기 크레딧($5 상당)으로는 BroadNet Gemma 4 VL 26B를 쓸 수 있습니다.
-   **“Bad request - please check your parameters”.** n8n 문서는 전체 오류를 보려면 같은 호출을 HTTP Request 노드에서 다시 해 보라고 권합니다. 여기서 흔한 원인은 Responses API 토글입니다.
-   **출력이 비어 있음.** 추론도 **Maximum Number of Tokens**에 포함됩니다. 값을 늘리세요. [답변이 비어서 오는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)를 참고하세요.
-   **루프에서 429.** 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. n8n 문서는 배치 속도를 조절하려면 **Loop Over Items**와 **Wait** 노드를 함께 쓰라고 권합니다. [오류와 재시도](https://broadrouter.com/ko/guides/errors-and-retries/)를 참고하세요.
-   **플랜 키로 병렬 실행.** [무제한 플랜 세션](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/)은 한 번에 요청 하나를 처리합니다. 실행마다 별도 세션이 없으면 병렬 워크플로 실행은 대기열에 쌓입니다.

코드가 더 편하다면 n8n의 AI 노드가 기반으로 하는 [LangChain](https://broadrouter.com/ko/guides/langchain-openai-base-url/)에서도 같은 설정이 통합니다.

## 이 가이드의 용어

[토큰(token)](https://broadrouter.com/ko/glossary/token/)

토큰은 언어 모델이 읽고 쓰는 텍스트 단위로, 모델의 토크나이저가 만들어 내는 단어, 단어의 일부, 문장 부호 또는 바이트 시퀀스입니다. LLM API는 사용량을 토큰 단위로 집계하고 제한하며, 대개 토큰 단위로 과금합니다.

[종량제(Pay-as-you-go)](https://broadrouter.com/ko/glossary/pay-as-you-go/)

종량제(pay-as-you-go)는 구독이나 최소 약정 없이 토큰, 요청, 오디오 분 같은 단위로 사용량을 측정해 쓴 만큼만 내는 요금 방식입니다. 대부분의 LLM API가 선불 잔액에서 차감하거나 정기 청구서를 발행하는 식으로 이렇게 과금합니다.

[base URL(베이스 URL)](https://broadrouter.com/ko/glossary/base-url/)

base URL은 https://api.example.com/v1처럼 API의 고정된 루트 주소로, 클라이언트가 /chat/completions 같은 모든 엔드포인트 경로 앞에 붙입니다. OpenAI 호환 SDK에서는 base URL을 API 키, 모델 ID와 함께 바꾸면 같은 코드로 다른 제공업체를 호출할 수 있습니다.

[AI 에이전트(AI agent)](https://broadrouter.com/ko/glossary/agent/)

AI 에이전트는 언어 모델이 목표를 향해 스스로 단계를 정하는 시스템입니다. 어떤 도구를 호출할지 결정하고, 결과를 읽고, 최종 답변을 내거나 한도에 닿을 때까지 이를 반복합니다. 정해진 지점에서 모델을 호출하는 고정된 스크립트는 보통 워크플로라고 부릅니다.

[도구 호출(tool calling)](https://broadrouter.com/ko/glossary/tool-calling/)

도구 호출(tool calling)은 함수 호출(function calling)이라고도 하며, 모델이 개발자가 정의한 함수를 실행해 달라는 구조화된 요청을 JSON 인자와 함께 반환하는 LLM API 기능입니다. 함수는 애플리케이션이 실행하고 그 결과를 다시 보냅니다. 모델이 직접 코드를 실행하지는 않습니다.

[동시 처리(concurrency)](https://broadrouter.com/ko/glossary/concurrency/)

동시 처리(concurrency)는 클라이언트가 같은 시점에 진행 중인 요청 수입니다. LLM API는 분당 요청 수와 별도로 키나 플랜마다 이를 제한하는 경우가 많습니다. 열려 있는 요청은 응답이 끝날 때까지 GPU 용량을 차지하기 때문입니다.

[속도 제한(rate limit)](https://broadrouter.com/ko/glossary/rate-limit/)

속도 제한(rate limit)은 API가 일정 시간 동안 클라이언트가 사용할 수 있는 양에 두는 상한으로, 분당 요청 수나 분당 토큰 수 같은 기준이 있습니다. 한도를 넘은 요청은 사용량이 다시 한도 아래로 내려갈 때까지 거부되며, 보통 HTTP 429 Too Many Requests가 반환됩니다.

[음성 인식(Speech-to-text, STT)](https://broadrouter.com/ko/glossary/speech-to-text/)

음성 인식(STT)은 자동 음성 인식(ASR)이라고도 하며, 말소리 오디오를 글로 변환하는 기술입니다. 음성 인식 API는 오디오 파일이나 스트림을 받아 전사 텍스트를 반환하며, 보통 오디오 분당 요금이 붙습니다. 정확도는 단어 오류율로 측정하며 억양, 방언, 녹음 품질에 따라 달라집니다.

## 자주 묻는 질문

### n8n AI Agent가 BroadNet에서 실패하는 이유는 무엇인가요?

OpenAI Chat Model 노드에서 Use Responses API가 꺼져 있는지 확인하세요. 노드 버전 1.3에서는 기본으로 켜져 있는데, BroadNet은 Responses API가 아니라 /v1/chat/completions를 제공합니다. 또 Model을 ID 모드로 바꾸고 BroadNet ID를 정확히 입력하세요.

### 모델 드롭다운이 비어 있거나 엉뚱한 모델이 나오는 이유는 무엇인가요?

From List 모드는 제공업체의 /models 엔드포인트를 읽습니다. BroadNet 문서는 이 엔드포인트를 모니터링용 공개 카탈로그 메타데이터라고 설명합니다. Model을 ID 모드로 바꾸고 BroadNet 모델 ID를 직접 입력하세요.

### n8n 에이전트의 출력이 비어 있는 이유는 무엇인가요?

추론이 Maximum Number of Tokens를 다 써 버린 것입니다. 값을 늘리거나 기본값 -1로 두세요.

### n8n OpenAI 자격 증명의 Base URL 필드는 어디에 있나요?

OpenAI 자격 증명 화면 안, API Key와 Organization ID 아래에 있습니다. 기본값은 https://api.openai.com/v1입니다. 이를 https://inference.broadnet.ai/v1로 바꾸되, /v1은 그대로 두고 뒤에 경로를 더 붙이지 마세요.

## 관련 가이드

-   [n8n에서 WhatsApp 음성 메시지 전사하기](https://broadrouter.com/ko/guides/n8n-whatsapp-voice-note-transcription/)
-   [BroadNet Inference에서 LangChain 사용하기](https://broadrouter.com/ko/guides/langchain-openai-base-url/)
-   [아랍어 음성 인식(STT) API 사용법: 단계별 가이드](https://broadrouter.com/ko/guides/arabic-speech-to-text-api/)
-   [추론 모델이 빈 답변을 반환하는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference 오류 코드와 재시도해야 하는 경우](https://broadrouter.com/ko/guides/errors-and-retries/)
-   [BroadNet Inference와 함께 쓸 수 있는 모든 도구 (영어)](https://broadrouter.com/integrations/): SDK, 코딩 에이전트, 채팅 UI, 자동화 도구와 각 도구의 정확한 설정

실제 워크로드로 테스트해 보세요. 신규 계정에는 US$5 상당의 초기 크레딧이 제공되며 Gemma 및 음성 전사에 사용할 수 있습니다. DeepSeek, GLM 및 Qwen3.8 모델은 충전이 필요합니다.

[시작하기](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-n8n-openai-compatible&utm_content=page-cta) ·

**출처**

-   [n8n 문서, OpenAI Chat Model 노드(2026-11-14 확인)](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/)
-   [n8n 문서, OpenAI Chat Model 자주 발생하는 문제(2026-11-14 확인)](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/common-issues/)
-   [n8n 문서, OpenAI 자격 증명(2026-11-14 확인)](https://docs.n8n.io/integrations/builtin/credentials/openai/)
-   [n8n 소스 코드, OpenAI 자격 증명 필드(2026-11-14 확인)](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/credentials/OpenAiApi.credentials.ts)
-   [n8n 소스 코드, OpenAI Chat Model 노드(2026-11-14 확인)](https://github.com/n8n-io/n8n/blob/master/packages/@n8n/nodes-langchain/nodes/llms/LMChatOpenAi/LmChatOpenAi.node.ts)
-   [BroadNet Inference API 레퍼런스 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-n8n-openai-compatible&utm_content=sources)
