---
title: "Миграция на OpenAI-совместимый API: чек-лист | BroadRouter"
description: "Сменить base_url — самое простое. Ломаются ID моделей, токены рассуждений, usage в стриминге, ошибки, лимиты запросов и ключи. Чек-лист с примерами кода."
url: https://broadrouter.com/ru/blog/openai-compatible-api-migration-checklist/
lang: ru
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Переведено с английского с помощью ИИ. [Читать оригинал на английском](https://broadrouter.com/blog/openai-compatible-api-migration-checklist/) (обновлён 2026-11-16).

# Переход на OpenAI-совместимый API: чек-лист миграции

Команда BroadNet Inference · 5 мин чтения · Опубликовано 2026-11-14 · Обновлено 2026-11-16

Чтобы перейти на OpenAI-совместимый API, измените три настройки (base\_url, api\_key и model), а затем проверьте, что отличается: ID моделей, то, как токены рассуждений учитываются в max\_tokens, как стриминг возвращает usage, какие ошибки повторять, лимиты запросов и безопасность ключей. Для BroadNet Inference базовый URL — https://inference.broadnet.ai/v1.

## Главное

-   Меняются три настройки: `base_url`, `api_key` и `model`.
-   Перед переходом составьте список всех эндпоинтов и полей, которые использует приложение, а затем проверьте каждый.
-   Модели с рассуждениями учитывают размышления в `max_tokens`; при маленьком лимите ответ приходит пустым.
-   Запрашивайте usage в стриме через `stream_options`, иначе учёт расходов ослепнет.
-   До переключения боевого трафика решите для каждого кода ошибки: повторять запрос или исправлять.
-   Перед окончательным переключением день гоняйте реальный трафик параллельно через старого и нового провайдера.

**На этой странице**

1.  0\. Что ваше приложение использует сейчас?
2.  1\. Какие три настройки меняются?
3.  2\. Какие новые ID моделей?
4.  3\. Почему после перехода приходят пустые ответы?
5.  4\. Возвращает ли стриминг usage, как раньше?
6.  5\. Какие ошибки стоит повторять?
7.  6\. Какие лимиты запросов у нового провайдера?
8.  7\. Поместятся ли ваши промпты?
9.  8\. Что с ключами и хранением данных?
10.  9\. Как безопасно переключиться?
11.  Какие ошибки при миграции встречаются чаще всего?
12.  Место BroadNet Inference

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

## 0\. Что ваше приложение использует сейчас?

Прежде чем что-то менять, запишите, от чего зависит приложение. Найдите в коде все вызовы SDK и составьте список. Если вы вызываете Whisper API от OpenAI, учтите, что OpenAI указывает дату отключения `whisper-1` — 26 февраля 2027 г.; аудио посвящена статья [альтернативы Whisper API](https://broadrouter.com/ru/blog/whisper-api-alternative/).

| Функция | Где искать | Что проверить после перехода |
| --- | --- | --- |
| Chat completions | Все `chat.completions.create` | Те же промпты, сравнить ответы |
| Стриминг | `stream=True` | Чанки приходят, в конце `[DONE]`, usage есть |
| Вызов инструментов | `tools=` | Вызовы инструментов парсятся и выполняются |
| Структурированный вывод | `response_format=` | JSON проходит валидацию по вашей схеме |
| Изображения | Части с изображениями в сообщениях | Модель их принимает |
| Транскрибация аудио | `audio.transcriptions` | Текст и язык верные |
| Эмбеддинги, файлы, batches | Другие эндпоинты | Проверить, есть ли они у провайдера вообще |

Последняя строка важна. «OpenAI-совместимый» обычно означает в первую очередь chat completions. В каталоге BroadNet Inference есть чат-модели на `/v1/chat/completions` и модели распознавания речи на `/v1/audio/transcriptions`; если вы используете другие эндпоинты, оставьте их у текущего провайдера или найдите замену.

## 1\. Какие три настройки меняются?

```python
from openai import OpenAI
import os

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

Название настройки [базового URL](https://broadrouter.com/ru/glossary/base-url/) зависит от библиотеки: `base_url` в Python SDK и в ChatOpenAI из LangChain, `baseURL` в Node.js SDK. Python SDK также читает переменную окружения `OPENAI_BASE_URL`, как сказано в его [README](https://github.com/openai/openai-python). Проверьте, не осталось ли там старого значения, иначе запросы могут уходить к старому провайдеру без всякой ошибки.

Храните [API-ключи](https://broadrouter.com/ru/glossary/api-key/) в переменных окружения или в менеджере секретов, но не в коде. Настройка для каждого SDK: [Python](https://broadrouter.com/ru/guides/openai-python-sdk/), [Node.js](https://broadrouter.com/ru/guides/openai-node-sdk/), [LangChain](https://broadrouter.com/ru/guides/langchain-openai-base-url/). Собрать и проверить первый запрос вручную можно в [конструкторе API-запросов](https://broadrouter.com/tools/api-request-builder/). Чтобы внести правки базового URL, ключа и модели в существующий код, вставьте его в [помощник миграции с OpenAI на BroadNet](https://broadrouter.com/tools/openai-to-broadnet-migration/) — он также подскажет, что проверить.

## 2\. Какие новые ID моделей?

Каждый провайдер называет модели по-своему. В BroadNet Inference:

| Модель | ID |
| --- | --- |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` |
| GLM 5.3 | `broadnet/glm-5.3` |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` |
| Gemma 4 VL 26B | `broadnet/gemma-4-26b-a4b` |

Выносите ID модели в конфигурацию, а не в код: тогда следующая смена будет деплоем, а не переписыванием. Лимиты и цены каждой модели — на её странице: [DeepSeek V4.1 Flash](https://broadrouter.com/ru/models/deepseek-v4.1-flash/), [GLM 5.3](https://broadrouter.com/ru/models/glm-5.3/), [Qwen3.8 27B](https://broadrouter.com/ru/models/qwen3.8-27b/) и [Gemma 4 VL 26B](https://broadrouter.com/ru/models/gemma-4-vl-26b/).

## 3\. Почему после перехода приходят пустые ответы?

Это самый частый сюрприз. DeepSeek V4.1 Flash, GLM 5.3 и Qwen3.8 27B рассуждают, прежде чем ответить, и **[токены рассуждений](https://broadrouter.com/ru/glossary/reasoning-tokens/) учитываются в [`max_tokens`](https://broadrouter.com/ru/glossary/max-tokens/)**. Лимит 256, которого хватало модели без рассуждений, может целиком уйти на размышления, и ответ придёт пустым. Оставляйте 1 000 токенов и больше или для простых задач задайте `reasoning_effort` равным `low`. [Подробное объяснение](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/).

## 4\. Возвращает ли стриминг usage, как раньше?

[Стриминг](https://broadrouter.com/ru/glossary/streaming/) использует Server-Sent Events и заканчивается на `data: [DONE]`. Расход токенов приходит в последнем чанке, только если вы его запросите:

```python
stream = client.chat.completions.create(
    model="broadnet/deepseek-v4.1-flash", messages=messages,
    stream=True, stream_options={"include_usage": True},
)
```

Без этого дашборд расходов будет показывать ноль. Если стрим оборвался до `[DONE]`, считайте ответ неполным. [Руководство по стримингу](https://broadrouter.com/ru/guides/streaming-chat-completions/).

## 5\. Какие ошибки стоит повторять?

| Статус | Значение | Действие |
| --- | --- | --- |
| 401 | Неверный или отозванный ключ либо исчерпан лимит оплаты по факту | Исправить, не повторять |
| 402 | Баланс или бюджет | Пополнить, не повторять |
| 403 | Отказ по политике модели, маршрута или IP | Устранить несоответствие |
| 413 | Слишком большой запрос | Уменьшить, не повторять |
| 429 | Лимит запросов, параллельности или расходов | Подождать и повторить |
| 5xx | Ошибка на стороне сервера | Повторить с ограниченной задержкой |

Официальный Python SDK уже повторяет часть ошибок: в README сказано, что ошибки соединения, ответы 408, 409, 429 и 5xx по умолчанию повторяются дважды с короткой экспоненциальной задержкой. Задайте `max_retries` явно, чтобы это поведение было вашим решением, а не значением по умолчанию. Логируйте ID запроса из каждого ответа, чтобы поддержка могла отследить проблему. [Все коды](https://broadrouter.com/ru/guides/errors-and-retries/).

## 6\. Какие лимиты запросов у нового провайдера?

Узнайте новые лимиты до того, как пойдёт трафик. Ключ BroadNet с оплатой по факту допускает 30 запросов в минуту и 4 одновременных. Безлимитные тарифы выполняют один запрос за раз на сессию. Подберите размер пула воркеров под это, иначе в первый же день увидите 429; размер поможет рассчитать [калькулятор лимитов запросов](https://broadrouter.com/tools/llm-rate-limit-calculator/). [Как рассчитать мощность для параллельных агентов](https://broadrouter.com/ru/blog/run-parallel-coding-agents-flat-rate/).

## 7\. Поместятся ли ваши промпты?

Проверьте контекстные окна: 1 048 576 токенов у DeepSeek V4.1 Flash и GLM 5.3, 262 144 у Qwen3.8 27B, 32 768 у Gemma 4 VL 26B. Промпт, который помещался в старую модель, может не поместиться в окно поменьше; проверьте в [калькуляторе контекстного окна](https://broadrouter.com/tools/context-window-calculator/). Ставьте неизменную часть промпта в начало, чтобы получить [цену входа из кэша](https://broadrouter.com/ru/blog/cached-input-tokens-explained/).

## 8\. Что с ключами и хранением данных?

Привяжите боевые ключи к IP ваших серверов через [белый список IP](https://broadrouter.com/ru/guides/api-keys-ip-allow-lists/). Спросите нового провайдера, что он хранит; см. [чек-лист ZDR](https://broadrouter.com/ru/blog/zero-data-retention-llm-api-checklist/).

## 9\. Как безопасно переключиться?

1.  Отправьте копию реальных запросов за день обоим провайдерам.
2.  Сравните ответы на выборке, а также задержку, ошибки и стоимость запроса.
3.  Переведите 10% трафика, понаблюдайте день, затем переведите остальное.
4.  Неделю держите старого провайдера настроенным как резервный.

Если у вас много сервисов, прокси вроде [LiteLLM](https://broadrouter.com/ru/guides/litellm-proxy-custom-provider/) позволяет переключать провайдера в одном месте, а не в каждом приложении.

## Какие ошибки при миграции встречаются чаще всего?

-   **Нет `/v1` в базовом URL.** Запросы возвращают 404. Указывайте полный URL.
-   **Старые названия моделей в конфиге.** Новый провайдер их не знает.
-   **В запросах остались поля конкретного провайдера.** Поля, которые понимал только старый провайдер, могут отклоняться или игнорироваться. Уберите их из универсальных клиентов.
-   **Проверка только одного промпта.** Пройдите инвентаризацию из шага 0, функцию за функцией.
-   **Переключение в пятницу.** Оставьте время, чтобы понаблюдать за полным днём реального трафика.

## Место BroadNet Inference

BroadNet Inference — это готовая замена для приложений, которые используют chat completions и транскрибацию аудио через OpenAI SDK: поменяйте три настройки и пройдите по списку выше. В её каталоге только чат-модели и модели распознавания речи, поэтому если вы зависите от других эндпоинтов, например эмбеддингов или хранения файлов, оставьте их у другого провайдера. Новые аккаунты получают стартовый грант $5. Из чат-моделей на нём работает только Gemma 4 VL 26B (он также покрывает обе модели Transcribe), поэтому для теневого теста на DeepSeek, GLM или Qwen нужно пополнить баланс.

Бесплатные инструменты по теме (на английском)

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[Бесплатные инструменты (на английском)](https://broadrouter.com/tools/)

## Термины в этой статье

[Вызов инструментов (tool calling)](https://broadrouter.com/ru/glossary/tool-calling/)

Вызов инструментов (function calling) — это функция LLM API, при которой модель возвращает структурированный запрос на выполнение функции, заданной разработчиком, с аргументами в JSON. Приложение выполняет функцию и отправляет результат обратно; сама модель код никогда не выполняет.

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

Chat Completions API — это HTTP-эндпоинт OpenAI, POST /v1/chat/completions, который принимает имя модели и список сообщений с ролями и возвращает следующее сообщение модели. Формат его запроса и ответа стал общим стандартом, который повторяют OpenAI-совместимые провайдеры и SDK.

[Лимит запросов (rate limit)](https://broadrouter.com/ru/glossary/rate-limit/)

Лимит запросов (rate limit) — это ограничение, которое API накладывает на объём использования клиентом за отрезок времени, например число запросов или токенов в минуту. Запросы сверх лимита отклоняются, обычно с HTTP 429 Too Many Requests, пока использование снова не опустится ниже порога.

[Оплата по факту (pay-as-you-go)](https://broadrouter.com/ru/glossary/pay-as-you-go/)

Оплата по факту (pay-as-you-go) — это модель ценообразования, при которой вы платите только за то, что использовали, по счётчику в единицах вроде токенов, запросов или минут аудио, без подписки и минимальных обязательств. Так тарифицирует большинство LLM API — с предоплаченного баланса или по периодическому счёту.

[Параллельность (concurrency)](https://broadrouter.com/ru/glossary/concurrency/)

Параллельность (concurrency) — это число запросов, которые клиент одновременно держит в работе. LLM API часто ограничивают её на ключ или тариф отдельно от лимита запросов в минуту, потому что каждый открытый запрос занимает мощности GPU, пока ответ не будет готов.

[Распознавание речи (speech-to-text)](https://broadrouter.com/ru/glossary/speech-to-text/)

Распознавание речи (speech-to-text, автоматическое распознавание речи, ASR) — это технология, которая превращает устную речь в письменный текст. API распознавания речи принимает аудиофайл или поток и возвращает расшифровку, обычно с оплатой за минуту аудио. Точность измеряют долей ошибок в словах (WER), и она зависит от акцента, диалекта и качества записи.

[Стриминг (streaming)](https://broadrouter.com/ru/glossary/streaming/)

Стриминг — это способ возвращать ответ языковой модели небольшими частями (чанками) прямо во время генерации, а не одним ответом в конце. OpenAI-совместимые API передают поток через server-sent events, если в запросе stream равен true.

[Белый список IP (IP allow list)](https://broadrouter.com/ru/glossary/ip-allow-list/)

Белый список IP — это механизм безопасности, который принимает запросы только с перечисленных IP-адресов или диапазонов CIDR и отклоняет все остальные. В API он ограничивает ущерб от утёкшего ключа, потому что ключ не работает из сетей, которых нет в списке.

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

### Нужен ли другой SDK?

Нет. Официальные OpenAI SDK для Python и Node.js принимают собственный базовый URL. Фреймворки поверх них, например ChatOpenAI из LangChain, тоже.

### Как поменять базовый URL в OpenAI SDK?

Передайте клиенту base\_url в Python или baseURL в Node.js либо задайте переменную окружения OPENAI\_BASE\_URL. Для BroadNet Inference значение — https://inference.broadnet.ai/v1, а ключ указывается в api\_key.

### Почему после перехода приходит пустой ответ?

Модели с рассуждениями, такие как DeepSeek V4.1 Flash, GLM 5.3 и Qwen3.8 27B, сначала размышляют, а потом отвечают, и размышления учитываются в max\_tokens. Поднимите max\_tokens до 1 000 и выше или задайте reasoning\_effort = low.

### Почему после перехода появляется ошибка 404 или model not found?

Обычно в ID модели осталось название от старого провайдера или в базовом URL не хватает пути /v1. Укажите точный ID модели нового провайдера и полный базовый URL.

### Какие ошибки стоит повторять?

Повторяйте 429 и 5xx с ограниченной экспоненциальной задержкой. Ошибки 401, 402 и 413 сначала исправьте, потом повторяйте. В руководстве по ошибкам на этом сайте перечислены все коды.

### OpenAI-совместимый — значит идентичный?

Нет. Формат запросов и ответов совпадает, но ID моделей, поддерживаемые параметры, лимиты, поля usage и детали ошибок могут отличаться. Проверьте каждую функцию, которую использует ваше приложение.

## Читайте также

-   [Базовые URL OpenAI-совместимых API: 14 провайдеров с проверкой](https://broadrouter.com/ru/blog/openai-compatible-api-base-urls/)
-   [OpenRouter или фиксированный тариф для ИИ-агентов: что дешевле?](https://broadrouter.com/ru/blog/openrouter-alternative-flat-rate/)
-   [Когда контекстное окно на 1 млн токенов оправдано (а когда нет)](https://broadrouter.com/ru/blog/million-token-context-window-guide/)
-   [Нулевое хранение данных (ZDR) в LLM API: чек-лист из 10 вопросов](https://broadrouter.com/ru/blog/zero-data-retention-llm-api-checklist/)
-   [GPU-парк и подход к инференсу BroadNet — по описанию самой BroadNet](https://broadrouter.com/ru/blog/broadnet-gpu-fleet-and-serving/)
-   [Кэширование ответов LLM API: кэш точных совпадений на Python](https://broadrouter.com/ru/blog/cache-llm-responses-cut-cost/)
-   [Руководство: 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 и когда повторять запрос](https://broadrouter.com/ru/guides/errors-and-retries/)
-   [Руководство: Стриминг chat completions и обрыв соединения](https://broadrouter.com/ru/guides/streaming-chat-completions/)
-   [Руководство: Почему рассуждающая модель возвращает пустой ответ](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/)
-   [Руководство: LiteLLM и BroadNet Inference: SDK и прокси](https://broadrouter.com/ru/guides/litellm-proxy-custom-provider/)

Проверьте на своей реальной нагрузке. Новые аккаунты получают стартовый грант US$5 на Gemma и распознавание речи. Для DeepSeek, GLM и Qwen3.8 нужно пополнить баланс.

[Начать](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-blog-openai-compatible-api-migration-checklist&utm_content=page-cta) ·

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

-   [Справочник API BroadNet Inference (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-blog-openai-compatible-api-migration-checklist&utm_content=sources)
-   [README OpenAI Python SDK (base\_url, OPENAI\_BASE\_URL, повторы; проверено 2026-11-14)](https://github.com/openai/openai-python)
