---
title: "Dify OpenAI-API-compatible 모델 제공자 설정(Base URL) | BroadRouter"
description: "OpenAI-API-compatible 모델 제공자 플러그인으로 Dify를 BroadNet Inference에 연결합니다. 필드별 입력값, 컨텍스트 크기, 함수 호출 설정을 정리했습니다."
url: https://broadrouter.com/ko/guides/dify-openai-api-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/dify-openai-api-compatible/) (2026-11-16 업데이트).

# OpenAI-API-compatible 플러그인으로 Dify에 BroadNet Inference 추가하기

업데이트 2026-11-16

Dify의 Integrations > Model Provider에서 OpenAI-API-compatible 플러그인을 설치하고 Add Model을 클릭하세요. 유형은 LLM으로 고르고 broadnet/glm-5.3 같은 BroadNet 모델 ID, BroadNet 키, API Base URL https://inference.broadnet.ai/v1을 입력합니다. Completion mode는 Chat, 컨텍스트 크기는 실제 값, 출력 한도는 추론할 여유가 있게 잡고, Tool Call은 GLM 5.3이나 Qwen3.8 27B에서만 선택하세요.

Dify는 LLM 앱과 워크플로를 만드는 오픈 소스 플랫폼입니다. Dify가 이름으로 지원하지 않는 제공업체는 Dify 팀(langgenius)이 배포하는 **OpenAI-API-compatible** 모델 제공자 플러그인으로 추가합니다. BroadNet Inference는 `https://inference.broadnet.ai/v1` 주소에서 표준 chat completions를 제공하므로 이 플러그인에 맞습니다. BroadRouter는 BroadNet이 운영하는 사이트이며, 아래 필드 이름은 플러그인 버전 0.0.83 기준입니다.

## 설정

1.  **키를 받습니다.** BroadNet 콘솔에서 종량제 키를 만드세요.
    
2.  **플러그인을 설치합니다.** Dify에서 **Integrations** > **Model Provider**로 이동해 설치 가능한 제공자 목록에서 **OpenAI-API-compatible**을 찾거나 [Marketplace](https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible)에서 열고 설치하세요. 워크스페이스 소유자나 관리자여야 합니다.
    
3.  **모델을 추가합니다.** 제공자 카드에서 **Add Model**을 클릭하고 다음과 같이 입력하세요.
    
    | 필드 | 값 |
    | --- | --- |
    | Model Type | LLM |
    | Model Name | `broadnet/glm-5.3` |
    | Model display name | GLM 5.3 (BroadNet) |
    | API Key | BroadNet 키 |
    | API Base URL | `https://inference.broadnet.ai/v1` |
    | Completion mode | Chat |
    | Model context size | `1048576` |
    | Upper bound for max tokens | `16000` |
    | Function Call Type | Tool Call |
    | Vision Support | Not Support |
    | Structured Output | Support |
    | API Type | Chat Completions API (/chat/completions) |
    | Token parameter name | Use max\_tokens |
    
4.  **저장합니다.** Dify는 모델을 추가하기 전에 자격 증명을 확인합니다.
    
5.  **테스트합니다.** Chatbot 앱을 만들고 모델 선택기에서 **GLM 5.3 (BroadNet)** 모델을 고른 뒤 미리보기 창에서 메시지를 보내 보세요.
    

쓰고 싶은 BroadNet 모델마다 **Add Model**을 반복하세요. 모델 이름은 `broadnet/` 접두사까지 포함해 BroadNet ID와 정확히 같아야 합니다.

## 모델별 입력값

| Model Name | 컨텍스트 크기 | Function Call Type | Vision Support |
| --- | --- | --- | --- |
| `broadnet/glm-5.3` | 1048576 | Tool Call | Not Support |
| `broadnet/qwen3.8-27b` | 262144 | Tool Call | Support |
| `broadnet/deepseek-v4.1-flash` | 1048576 | Not Support (테스트하지 않음) | Support |
| `broadnet/gemma-4-26b-a4b` | 32768 | Not Support | Support |

이렇게 고른 이유는 다음과 같습니다.

-   **컨텍스트 크기**는 플러그인 기본값이 4,096입니다. 그대로 두면 Dify가 메모리와 검색된 컨텍스트를 모델이 받을 수 있는 양보다 훨씬 적게 잘라 냅니다.
-   **Upper bound for max tokens**도 기본값이 4,096입니다. 네 모델 중 세 개는 답하기 전에 추론하며 추론도 이 한도에 포함되므로 여유를 주세요. 16,000은 저희 제안값이며 BroadNet의 한도가 아닙니다.
-   **Token parameter name**을 `max_tokens`로 설정하면 BroadNet API 레퍼런스의 필드와 일치합니다. 플러그인 기본값은 모델 이름으로 추측하는 방식입니다.
-   **API Type**은 Chat Completions로 둡니다. BroadNet은 Responses API를 제공한다고 표기하지 않습니다.

## 음성 전사

이 플러그인으로 음성 인식(speech-to-text) 모델도 추가할 수 있습니다. BroadNet은 `/v1/audio/transcriptions`에서 아랍어용 `broadnet/cohere-transcribe-arabic` 모델과 14개 언어용 `broadnet/cohere-transcribe` 모델을 제공합니다. 플러그인 README에 따르면 speech-to-text에서는 플러그인이 버전 경로를 직접 붙이므로, 예제는 `/v1` 없이 호스트만 씁니다(여기서는 `https://inference.broadnet.ai`). 저희는 이 경로를 Dify에서 테스트하지 않았으니, 먼저 짧은 WAV 파일로 확인하세요. [아랍어 음성 인식 가이드](https://broadrouter.com/ko/guides/arabic-speech-to-text-api/)를 참고하세요.

## 문제 해결

-   **자격 증명 확인이 실패함.** 키, API Base URL(LLM이라면 `/v1`로 끝남), 모델 이름을 확인하세요. 유료 모델은 충전이 필요하며, 초기 크레딧($5 상당)은 `broadnet/gemma-4-26b-a4b` 모델과 Transcribe 모델 두 개에만 쓸 수 있습니다.
-   **워크플로에서 빈 답변이 나옴.** LLM 노드의 max tokens가 추론 모델에 비해 너무 낮습니다. 값을 늘리세요. [답변이 비어서 오는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)를 참고하세요.
-   **Agent 노드가 도구를 호출하지 않음.** Function Call Type을 Tool Call로 설정한 GLM 5.3이나 Qwen3.8 27B를 쓰세요.
-   **부하가 걸리면 429.** 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. 병렬 브랜치와 반복(iteration) 노드는 이를 넘길 수 있으니 병렬 수준을 낮추세요. [오류와 재시도](https://broadrouter.com/ko/guides/errors-and-retries/)를 참고하세요.

## 이 가이드의 용어

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

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

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

음성 인식(STT)은 자동 음성 인식(ASR)이라고도 하며, 말소리 오디오를 글로 변환하는 기술입니다. 음성 인식 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와 함께 바꾸면 같은 코드로 다른 제공업체를 호출할 수 있습니다.

[컨텍스트 윈도우(context window)](https://broadrouter.com/ko/glossary/context-window/)

컨텍스트 윈도우는 언어 모델이 요청 한 번에 다룰 수 있는 최대 토큰 수입니다. 프롬프트, 대화 기록, 도구 정의, 이미지, 그리고 추론 토큰을 포함한 생성 출력이 모두 여기에 들어갑니다. 들어가지 않는 내용은 잘라 내거나 요약하거나 여러 요청으로 나눠야 합니다.

[구조화된 출력(Structured output)](https://broadrouter.com/ko/glossary/structured-output/)

구조화된 출력(structured output)은 모델의 응답을 개발자가 지정한 형식, 주로 JSON Schema에 맞추도록 제한해 코드가 안정적으로 파싱할 수 있게 하는 LLM API 기능입니다. 유효한 JSON만 보장하고 특정 구조는 보장하지 않는 JSON 모드보다 더 엄격합니다.

[Chat Completions API](https://broadrouter.com/ko/glossary/chat-completions-api/)

Chat Completions API는 OpenAI의 HTTP 엔드포인트인 POST /v1/chat/completions로, 모델 이름과 역할이 붙은 메시지 목록을 받아 모델의 다음 메시지를 반환합니다. 이 요청과 응답 구조는 OpenAI 호환 제공업체와 SDK가 재사용하는 공통 형식이 되었습니다.

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

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

## 자주 묻는 질문

### 셀프 호스팅 Dify뿐 아니라 Dify Cloud에서도 BroadNet을 쓸 수 있나요?

네. BroadNet Inference는 공개 HTTPS 엔드포인트이므로 Dify Cloud에서도 접근할 수 있습니다. Dify 문서에 따르면 모델 제공자는 워크스페이스 소유자와 관리자만 관리할 수 있고, 추가한 키는 워크스페이스 전체에서 작동합니다.

### API Base URL에 /v1을 넣어야 하나요?

LLM 모델이라면 넣어야 합니다. 플러그인 자체 예제도 채팅 모델에는 /v1로 끝나는 Base URL을 쓰며, README는 일부 다른 모델 유형에서는 플러그인이 버전 경로를 직접 붙인다고 경고합니다.

### Function Call Type은 무엇을 골라야 하나요?

BroadNet이 도구 지원을 표기한 GLM 5.3과 Qwen3.8 27B에는 Tool Call을 고르세요. DeepSeek V4.1 Flash는 직접 도구 호출을 테스트해 보지 않았다면 Not Support를 고르세요.

### Dify AI 크레딧을 BroadNet 모델에 쓸 수 있나요?

아니요. Dify 문서에 따르면 AI 크레딧은 본인 계정으로 연결한 제공자에는 적용되지 않습니다. 요금은 입력한 키를 기준으로 BroadNet이 청구합니다.

## 관련 가이드

-   [n8n에서 BroadNet Inference 사용하기(OpenAI 자격 증명, Base URL)](https://broadrouter.com/ko/guides/n8n-openai-compatible/)
-   [Open WebUI를 BroadNet Inference에 연결하기](https://broadrouter.com/ko/guides/open-webui-openai-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-dify-openai-api-compatible&utm_content=page-cta) ·

**출처**

-   [Dify 문서, Model Providers(2026-11-15 확인)](https://docs.dify.ai/en/cloud/use-dify/workspace/model-providers)
-   [Dify Marketplace, langgenius의 OpenAI-API-compatible 플러그인 버전 0.0.83(2026-11-15 확인)](https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible)
-   [플러그인 소스, openai\_api\_compatible 제공자 필드(2026-11-15 확인)](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible)
-   [BroadNet Inference API 레퍼런스(2026-11-15 확인) (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-dify-openai-api-compatible&utm_content=sources)
