BroadRouter

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

업데이트

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만 토큰 컨텍스트, 도구 표기 없음

가격은 가격 페이지에서 비교하세요. 오디오는 n8n의 HTTP Request 노드로 /v1/audio/transcriptions에 파일을 보낼 수 있습니다. 보내야 할 폼 필드는 아랍어 음성 인식 가이드에 나와 있습니다.

문제 해결

  • 자격 증명 테스트 실패. 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에 포함됩니다. 값을 늘리세요. 답변이 비어서 오는 이유를 참고하세요.
  • 루프에서 429. 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. n8n 문서는 배치 속도를 조절하려면 Loop Over Items와 Wait 노드를 함께 쓰라고 권합니다. 오류와 재시도를 참고하세요.
  • 플랜 키로 병렬 실행. 무제한 플랜 세션은 한 번에 요청 하나를 처리합니다. 실행마다 별도 세션이 없으면 병렬 워크플로 실행은 대기열에 쌓입니다.

코드가 더 편하다면 n8n의 AI 노드가 기반으로 하는 LangChain에서도 같은 설정이 통합니다.

자주 묻는 질문

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은 그대로 두고 뒤에 경로를 더 붙이지 마세요.

Markdown으로 읽기ChatGPT에 질문하기Claude에 질문하기Perplexity에 질문하기