---
title: "Что такое base URL в LLM API? С примерами | BroadRouter"
description: "Базовый URL — корневой адрес, который SDK подставляет перед каждым путём API. Как он работает в OpenAI-совместимых клиентах и какие ошибки приводят к 404."
url: https://broadrouter.com/ru/glossary/base-url/
lang: ru
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Переведено с английского с помощью ИИ. [Читать оригинал на английском](https://broadrouter.com/glossary/base-url/) (обновлён 2026-11-15).

# Базовый URL (base URL)

Обновлено 2026-11-15

Базовый URL — это фиксированный корневой адрес API, например https://api.example.com/v1, который клиент подставляет перед каждым путём эндпоинта, например /chat/completions. В OpenAI-совместимых SDK смена базового URL вместе с API-ключом и ID модели направляет тот же код к другому провайдеру.

Также называют: base\_url, базовый адрес API, адрес эндпоинта, URL API, base URL, API base URL, api\_base, baseURL, OPENAI\_BASE\_URL, endpoint URL

Каждый запрос SDK — это базовый URL плюс путь. Укажите базовый URL правильно, и остальной клиент заработает без изменений.

## Как это работает

Клиент соединяет две части:

| Часть | Пример |
| --- | --- |
| Базовый 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`.

## Почему это важно

Именно базовый URL делает переход на [OpenAI-совместимый API](https://broadrouter.com/ru/glossary/openai-compatible-api/) простой заменой. Он же определяет, куда уходят ваши промпты и кто выставляет вам счёт. Ошибочное значение может отправить трафик — и ваш [API-ключ](https://broadrouter.com/ru/glossary/api-key/) — не тому провайдеру. Храните его в конфигурации рядом с ключом, а не прописывайте в нескольких местах кода.

Роутеры используют ту же идею: вы направляете базовый URL на [роутер](https://broadrouter.com/ru/glossary/llm-router/), а не на провайдера модели.

## В BroadNet Inference

Базовый URL — `https://inference.broadnet.ai/v1` для всех моделей: чата, vision и распознавания речи. Чат идёт на `/chat/completions`, транскрибация — на `/audio/transcriptions`. Первый запрос показан в [быстром старте с curl](https://broadrouter.com/ru/guides/curl-quickstart/), а где эта настройка находится во фреймворке — в [руководстве по LangChain](https://broadrouter.com/ru/guides/langchain-openai-base-url/).

## Частые ошибки

-   **Нет `/v1`.** `https://inference.broadnet.ai` без `/v1` приводит к ошибкам 404 в SDK.
-   **Задвоенный путь.** Если вставить в базовый URL полный эндпоинт, например `.../v1/chat/completions`, SDK будет вызывать `.../chat/completions/chat/completions`.
-   **Забытые переменные окружения.** Старая `OPENAI_BASE_URL` в вашей оболочке перекрывает то, что вы ожидаете. Если запросы уходят не туда, выведите её значение.
-   **Обычный HTTP.** Всегда используйте `https://`. Bearer-ключи должны передаваться по TLS.
-   **Сменили URL, но не модель.** У каждого провайдера свои ID моделей, например `broadnet/deepseek-v4.1-flash`.

Переносите приложение целиком? Пройдите по [чек-листу миграции](https://broadrouter.com/ru/blog/openai-compatible-api-migration-checklist/).

## Вопросы и ответы

### Должен ли базовый URL заканчиваться на /v1?

Для OpenAI-совместимых SDK — да, если пути провайдера начинаются с /v1. Тогда SDK сам добавляет пути вроде /chat/completions. Точное значение сверьте с документацией провайдера.

### Можно ли задать базовый URL, не меняя код?

Да. Официальные SDK OpenAI для Python и Node читают переменную окружения OPENAI\_BASE\_URL, если базовый URL не передан. У некоторых инструментов свои имена переменных, например OPENAI\_API\_BASE в Aider.

### Какой базовый URL у BroadNet Inference?

https://inference.broadnet.ai/v1

## См. также

-   [OpenAI-совместимый API](https://broadrouter.com/ru/glossary/openai-compatible-api/) (термин)
-   [API-ключ (API key)](https://broadrouter.com/ru/glossary/api-key/) (термин)
-   [LLM-роутер (LLM router)](https://broadrouter.com/ru/glossary/llm-router/) (термин)
-   [OpenAI Python SDK и BroadNet Inference](https://broadrouter.com/ru/guides/openai-python-sdk/) (руководство)
-   [OpenAI Node.js SDK и BroadNet Inference](https://broadrouter.com/ru/guides/openai-node-sdk/) (руководство)
-   [LangChain и BroadNet Inference](https://broadrouter.com/ru/guides/langchain-openai-base-url/) (руководство)
-   [Первый запрос к BroadNet Inference через curl](https://broadrouter.com/ru/guides/curl-quickstart/) (руководство)
-   [Переход на OpenAI-совместимый API: чек-лист миграции](https://broadrouter.com/ru/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=ru-glossary-base-url&utm_content=page-cta) ·

**Источники**

-   [README OpenAI Python SDK (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 (пример стороннего базового URL)](https://openrouter.ai/docs/quickstart)
-   [Справочник API BroadNet Inference (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-glossary-base-url&utm_content=sources)
