---
title: "Open WebUI OpenAI 호환 API 연결 설정 | BroadRouter"
description: "BroadNet Inference를 Open WebUI에 OpenAI 호환 연결로 추가하고 모델 ID를 허용 목록에 넣는 방법, 연결 확인 실패·빈 응답·속도 제한 문제의 해결법을 정리했습니다."
url: https://broadrouter.com/ko/guides/open-webui-openai-api/
lang: ko
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# Open WebUI를 BroadNet Inference에 연결하기

업데이트 2026-11-16

Open WebUI 관리자 영역의 Settings > Connections로 가서 Manage OpenAI API Connections 아래의 Add Connection을 클릭하세요. URL은 https://inference.broadnet.ai/v1, API Key는 BroadNet 키로 입력하고, broadnet/glm-5.3 같은 모델 ID를 Model IDs 허용 목록에 추가한 뒤 저장하면 됩니다.

Open WebUI는 직접 호스팅하는 채팅 인터페이스입니다. OpenAI chat completions 프로토콜을 구현한 제공업체라면 어디든 연결할 수 있고, BroadNet Inference도 이를 구현합니다. 아래 단계는 [OpenAI 호환 제공자에 대한 Open WebUI 가이드](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible)를 따릅니다.

## 설정

1.  **BroadNet 키를 받습니다.** 여러 사람이 쓰는 채팅 UI에는 종량제 키가 맞습니다. [API 키와 IP 허용 목록](https://broadrouter.com/ko/guides/api-keys-ip-allow-lists/)을 참고하세요.
    
2.  **연결 페이지를 엽니다.** 관리자 영역의 **Settings > Connections**로 가서 **Manage OpenAI API Connections**를 찾으세요.
    
3.  **Add Connection을 클릭하고** 다음과 같이 입력하세요.
    
    | 필드 | 값 |
    | --- | --- |
    | URL | `https://inference.broadnet.ai/v1` (끝에 슬래시 없음) |
    | API Key | BroadNet 키 |
    | Model IDs | 아래 ID를 **+** 아이콘으로 하나씩 추가 |
    
4.  **모델 ID를 직접 추가합니다.** `broadnet/glm-5.3` 값을 입력하고 \*\*+\*\*를 클릭한 뒤, 원하는 다른 모델도 같은 방식으로 추가하세요. BroadNet 문서는 `GET /v1/models`를 모니터링용 공개 카탈로그 메타데이터라고 설명하므로, 모델 선택 목록을 채우는 용도로 기대하지 마세요.
    
5.  **Save를 클릭합니다.** Open WebUI 문서에 따르면 저장할 때 연결을 테스트하지는 않습니다.
    
6.  **채팅을 시작하고** 모델 선택기에서 모델을 고르세요.
    

### 환경 변수로 설정하기

Open WebUI를 Docker로 실행한다면 시작할 때 연결을 설정할 수 있습니다.

```bash
OPENAI_API_BASE_URL=https://inference.broadnet.ai/v1
OPENAI_API_KEY=your-broadnet-key
```

기존 OpenAI 연결 옆에 BroadNet을 추가하려면 복수형 변수 `OPENAI_API_BASE_URLS`와 `OPENAI_API_KEYS`를 쓰고 값을 세미콜론으로 구분하세요. `OPENAI_API_CONFIGS`는 `model_ids` 같은 연결별 옵션을 설정하며, 목록에서 그 연결의 인덱스를 키로 씁니다.

```bash
OPENAI_API_CONFIGS='{"0": {"enable": true, "model_ids": ["broadnet/glm-5.3", "broadnet/qwen3.8-27b"]}}'
```

Open WebUI의 [환경 변수 레퍼런스](https://docs.openwebui.com/reference/env-configuration)는 이 값들을 ConfigVar 설정으로 표시합니다. 첫 실행 때 읽어서 데이터베이스에 저장하고, 그 뒤로는 관리자 패널의 값이 우선합니다. 관리자 영역의 **Settings > Connections**에서 연결을 수정하거나, 시작할 때마다 환경 변수를 적용하고 싶다면 `ENABLE_PERSISTENT_CONFIG=False`를 설정하세요.

## 어떤 모델을 고를까

| 용도 | 모델 | 컨텍스트 |
| --- | --- | --- |
| 일반 채팅, 도구, JSON | `broadnet/glm-5.3` | 1,048,576 |
| 이미지 질문, 아랍어 | `broadnet/qwen3.8-27b` | 262,144 |
| 긴 문서, 이미지 | `broadnet/deepseek-v4.1-flash` | 1,048,576 |
| 저비용, 무료 크레딧 | `broadnet/gemma-4-26b-a4b` | 32,768 |

BroadNet은 걸프 방언과 이집트 방언을 포함해 아랍어로 Qwen3.8 27B를 테스트했습니다. [아랍어용 LLM 고르기](https://broadrouter.com/ko/blog/choosing-an-llm-for-arabic/)를 참고하세요. 초기 크레딧($5 상당)으로 쓸 수 있는 채팅 모델은 Gemma 4 VL 26B뿐이며, 이 크레딧은 Transcribe 모델 두 개에도 쓸 수 있습니다. 모델별 가격은 [가격 페이지](https://broadrouter.com/ko/pricing/)에 있습니다.

Open WebUI는 `temperature`, `max_tokens` 같은 표준 파라미터를 전달하며, 모델과 서버가 `tools`를 지원하면 도구 사용도 지원합니다. BroadNet은 GLM 5.3과 Qwen3.8 27B에 도구를 표기합니다.

## 문제 해결

-   **Verify Connection이 400, 401, 403으로 실패함.** Open WebUI의 확인 버튼은 `/models`를 호출합니다. Open WebUI 문서에 따르면 그래도 chat completions는 작동할 수 있습니다. ID를 허용 목록에 추가하고 채팅을 테스트해 보세요. 채팅도 401을 반환한다면 키가 틀렸거나 만료되었거나, 종량제 사용 가능 금액이 소진된 것입니다.
-   **모델은 목록에 있는데 첫 메시지가 실패함.** ID가 `broadnet/` 접두사까지 포함해 BroadNet의 ID와 정확히 같은지 확인하세요. GLM 5.3, Qwen3.8 27B, DeepSeek V4.1 Flash는 충전이 필요합니다.
-   **빈 응답.** 추론 모델(DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B)은 출력 토큰을 먼저 추론에 씁니다. 모델의 **Advanced Params**에서 **max\_tokens**를 설정했다면 늘리거나 지우세요. [답변이 비어서 오는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)를 참고하세요.
-   **여러 사람이 채팅할 때 429.** 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. Open WebUI는 채팅 제목 생성 같은 백그라운드 호출도 같은 키로 보냅니다. [오류와 재시도](https://broadrouter.com/ko/guides/errors-and-retries/)를 참고하세요.
-   **환경 변수를 바꿔도 반영되지 않음.** 첫 실행 때 예전 값이 저장되었습니다. 관리자 패널에서 연결을 수정하거나 위의 환경 변수 섹션을 참고하세요.
-   **플랜 키 사용.** [무제한 플랜 세션](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/)은 한 번에 요청 하나를 처리하고, 키는 공유할 수 없습니다. 혼자 쓰는 개인 인스턴스에 적합하며, 다른 사용자의 요청은 대기열에 쌓입니다.

## 이 가이드의 용어

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

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

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

토큰은 언어 모델이 읽고 쓰는 텍스트 단위로, 모델의 토크나이저가 만들어 내는 단어, 단어의 일부, 문장 부호 또는 바이트 시퀀스입니다. 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가 반환됩니다.

[API 키(API key)](https://broadrouter.com/ko/glossary/api-key/)

API 키는 API를 호출하는 클라이언트를 식별하고 승인하는 비밀 문자열입니다. LLM API는 보통 이 키를 Authorization: Bearer 헤더로 받으며, 키를 가진 사람은 누구나 키 소유 계정으로 과금되는 요청을 보낼 수 있습니다.

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

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

[max\_tokens(최대 출력 토큰)](https://broadrouter.com/ko/glossary/max-tokens/)

max\_tokens는 모델이 응답 하나에서 생성할 수 있는 최대 토큰 수를 정하는 LLM API 파라미터입니다. 생성이 이 한도에 닿으면 멈추고, 응답에는 잘렸다는 표시가 붙습니다. 예를 들어 finish\_reason이 "length"로 설정됩니다.

[OpenAI 호환 API(OpenAI-compatible API)](https://broadrouter.com/ko/glossary/openai-compatible-api/)

OpenAI 호환 API는 POST /v1/chat/completions처럼 OpenAI API와 같은 요청 및 응답 형식을 받는 HTTP API입니다. 그래서 OpenAI SDK와 도구는 base URL, API 키, 모델 이름만 바꾸면 이 API를 그대로 사용할 수 있습니다.

## 자주 묻는 질문

### Verify Connection은 실패하는데 채팅은 되는 이유는 무엇인가요?

Open WebUI의 연결 확인 버튼은 제공업체의 /models 엔드포인트를 호출합니다. Open WebUI 문서에 따르면 확인에 실패해도 채팅이 안 된다는 뜻은 아닙니다. BroadNet 모델 ID를 Model IDs 허용 목록에 직접 추가하세요.

### 환경 변수로 연결을 설정할 수 있나요?

네. OPENAI\_API\_BASE\_URL을 https://inference.broadnet.ai/v1로, OPENAI\_API\_KEY를 BroadNet 키로 설정하세요. Open WebUI는 이 값을 첫 실행 때 저장하므로, ENABLE\_PERSISTENT\_CONFIG가 False가 아니면 이후 변수를 바꿔도 무시됩니다.

### 새로 바꾼 OPENAI\_API\_BASE\_URL 값이 적용되지 않는 이유는 무엇인가요?

Open WebUI는 이 값을 ConfigVar로 다룹니다. 첫 실행 이후에는 데이터베이스에 저장된 값을 씁니다. 관리자 영역의 Settings > Connections에서 URL을 바꾸거나, 시작할 때마다 환경 변수를 읽도록 ENABLE\_PERSISTENT\_CONFIG=False를 설정하세요.

### Open WebUI에서 팀 전체가 무제한 플랜 키 하나를 공유해도 되나요?

안 됩니다. BroadNet 플랜은 키 공유를 허용하지 않으며, 플랜 세션 하나는 한 번에 요청 하나를 처리합니다. 여럿이 함께 쓰는 Open WebUI에는 종량제 키를 쓰세요.

## 관련 가이드

-   [LibreChat에 BroadNet Inference를 커스텀 엔드포인트로 추가하기](https://broadrouter.com/ko/guides/librechat-custom-endpoint/)
-   [추론 모델이 빈 답변을 반환하는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)
-   [에이전트용 무제한 LLM API 플랜은 어떻게 작동하나요?](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/)
-   [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-open-webui-openai-api&utm_content=page-cta) ·

**출처**

-   [Open WebUI 문서, OpenAI 호환 제공자(2026-11-16 확인)](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible)
-   [Open WebUI 문서, 환경 변수 설정(2026-11-14 확인)](https://docs.openwebui.com/reference/env-configuration)
-   [BroadNet Inference API 레퍼런스 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-open-webui-openai-api&utm_content=sources)
