---
title: "LLM API base URL이란? 예제로 보는 설정 방법 | BroadRouter"
description: "base URL은 SDK가 모든 API 경로 앞에 붙이는 루트 주소입니다. OpenAI 호환 클라이언트에서 어떻게 동작하는지, 404 오류를 부르는 흔한 실수는 무엇인지 정리했습니다."
url: https://broadrouter.com/ko/glossary/base-url/
lang: ko
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# base URL(베이스 URL)

업데이트 2026-11-15

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

다른 이름: 베이스 URL, 기본 URL, base\_url 설정, API 기본 주소, API base URL, api\_base, baseURL, OPENAI\_BASE\_URL, endpoint URL

SDK가 보내는 모든 요청은 base URL에 경로를 붙인 주소로 갑니다. base URL만 제대로 설정하면 나머지 클라이언트 코드는 그대로 동작합니다.

## 작동 방식

클라이언트는 두 부분을 이어 붙입니다.

| 구성 요소 | 예시 |
| --- | --- |
| base URL | `https://inference.broadnet.ai/v1` |
| 엔드포인트 경로 | `/chat/completions` |
| 전체 요청 URL | `https://inference.broadnet.ai/v1/chat/completions` |

코드에서 쓰는 파라미터 이름은 라이브러리마다 다릅니다.

```python
# Python SDK
client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
```

```js
// Node SDK
const client = new OpenAI({ baseURL: "https://inference.broadnet.ai/v1", apiKey: process.env.BROADNET_API_KEY });
```

두 공식 SDK 모두 값이 없으면 `OPENAI_BASE_URL` 환경 변수를 쓰고, 그것도 설정되지 않았으면 OpenAI 자체 주소를 씁니다. 다른 도구는 `api_base`나 `OPENAI_API_BASE` 같은 이름을 씁니다.

## 왜 중요한가

base URL 덕분에 [OpenAI 호환 API](https://broadrouter.com/ko/glossary/openai-compatible-api/)로 그대로 갈아 끼울 수 있습니다. base URL은 프롬프트가 어디로 가는지, 누가 요금을 청구하는지도 결정합니다. 값이 틀리면 트래픽과 [API 키](https://broadrouter.com/ko/glossary/api-key/)가 엉뚱한 제공업체로 갈 수 있습니다. 여러 곳에 하드코딩하지 말고 키와 함께 설정에 두세요.

라우터도 같은 원리를 씁니다. base URL을 모델 제공업체 대신 [라우터](https://broadrouter.com/ko/glossary/llm-router/)로 지정하면 됩니다.

## BroadNet Inference에서는

base URL은 채팅, 비전, 음성 인식 등 모든 모델에서 `https://inference.broadnet.ai/v1` 주소입니다. 채팅은 `/chat/completions`로, 전사는 `/audio/transcriptions`로 보냅니다. [curl 빠른 시작](https://broadrouter.com/ko/guides/curl-quickstart/)에서 첫 요청을 보내는 방법을, [LangChain 가이드](https://broadrouter.com/ko/guides/langchain-openai-base-url/)에서 프레임워크 안의 설정 위치를 확인할 수 있습니다.

## 흔한 실수

-   **`/v1` 누락.** `/v1` 없이 `https://inference.broadnet.ai`만 쓰면 SDK에서 404 오류가 발생합니다.
-   **경로 중복.** `.../v1/chat/completions` 같은 전체 엔드포인트를 base URL에 붙여 넣으면 SDK가 `.../chat/completions/chat/completions`를 호출합니다.
-   **남아 있는 환경 변수.** 셸에 남은 예전 `OPENAI_BASE_URL` 값이 예상한 설정을 덮어씁니다. 요청이 엉뚱한 곳으로 가면 이 값을 출력해 보세요.
-   **일반 HTTP.** 항상 `https://`를 쓰세요. Bearer 키는 TLS로만 전송해야 합니다.
-   **URL만 바꾸고 모델은 그대로 두는 것.** 제공업체마다 `broadnet/deepseek-v4.1-flash` 같은 고유한 모델 ID가 있습니다.

앱 전체를 옮기시나요? [마이그레이션 체크리스트](https://broadrouter.com/ko/blog/openai-compatible-api-migration-checklist/)를 차례로 확인하세요.

## 자주 묻는 질문

### base URL은 /v1로 끝나야 하나요?

OpenAI 호환 SDK에서는 제공업체의 경로가 /v1로 시작한다면 그렇습니다. 그러면 SDK가 /chat/completions 같은 경로를 뒤에 덧붙입니다. 정확한 값은 제공업체 문서에서 확인하세요.

### 코드를 바꾸지 않고 base URL을 설정할 수 있나요?

네. 공식 OpenAI Python SDK와 Node SDK는 base URL을 넘기지 않으면 OPENAI\_BASE\_URL 환경 변수를 읽습니다. Aider의 OPENAI\_API\_BASE처럼 자체 변수 이름을 쓰는 도구도 있습니다.

### BroadNet Inference의 base URL은 무엇인가요?

https://inference.broadnet.ai/v1 주소입니다.

## 함께 보기

-   [OpenAI 호환 API(OpenAI-compatible API)](https://broadrouter.com/ko/glossary/openai-compatible-api/) (용어)
-   [API 키(API key)](https://broadrouter.com/ko/glossary/api-key/) (용어)
-   [LLM 라우터(LLM router)](https://broadrouter.com/ko/glossary/llm-router/) (용어)
-   [BroadNet Inference에서 OpenAI Python SDK 사용하기](https://broadrouter.com/ko/guides/openai-python-sdk/) (가이드)
-   [BroadNet Inference에서 OpenAI Node.js SDK 사용하기](https://broadrouter.com/ko/guides/openai-node-sdk/) (가이드)
-   [BroadNet Inference에서 LangChain 사용하기](https://broadrouter.com/ko/guides/langchain-openai-base-url/) (가이드)
-   [curl로 BroadNet Inference에 첫 요청 보내기](https://broadrouter.com/ko/guides/curl-quickstart/) (가이드)
-   [OpenAI 호환 API로 전환하기: 마이그레이션 체크리스트](https://broadrouter.com/ko/blog/openai-compatible-api-migration-checklist/) (글)

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

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

**출처**

-   [OpenAI Python SDK README(base\_url과 OPENAI\_BASE\_URL)](https://github.com/openai/openai-python)
-   [OpenAI Node SDK(baseURL, 기본값은 OPENAI\_BASE\_URL)](https://github.com/openai/openai-node)
-   [OpenRouter 빠른 시작(서드파티 base URL 예시)](https://openrouter.ai/docs/quickstart)
-   [BroadNet Inference API 레퍼런스 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-glossary-base-url&utm_content=sources)
