---
title: "Dify: OpenAI-совместимый провайдер и API Base URL | BroadRouter"
description: "Как подключить Dify к BroadNet Inference через плагин провайдера моделей OpenAI-API-compatible: точные значения полей, размеры контекста и настройки вызова функций."
url: https://broadrouter.com/ru/guides/dify-openai-api-compatible/
lang: ru
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# BroadNet Inference в Dify через плагин OpenAI-API-compatible

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

В Dify установите плагин OpenAI-API-compatible в Integrations > Model Provider и нажмите Add Model. Выберите тип LLM, укажите ID модели BroadNet, например broadnet/glm-5.3, свой ключ BroadNet и API Base URL https://inference.broadnet.ai/v1. Задайте Completion mode = Chat, реальный размер контекста, лимит на выход с запасом на рассуждения и Tool Call только для GLM 5.3 или Qwen3.8 27B.

Dify — платформа с открытым исходным кодом для создания LLM-приложений и рабочих процессов. Провайдеров, которых Dify не перечисляет по имени, добавляют через плагин провайдера моделей **OpenAI-API-compatible** от команды Dify (langgenius). BroadNet Inference отдаёт стандартные chat completions по адресу `https://inference.broadnet.ai/v1`, поэтому подходит. 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)** в списке моделей и отправьте сообщение в панели предпросмотра.
    

Повторите **Add Model** для каждой нужной модели BroadNet. Имя модели должно точно совпадать с ID BroadNet, включая префикс `broadnet/`.

## Значения для каждой модели

| 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 |

Почему именно так:

-   **Размер контекста** в плагине по умолчанию 4096. Если его не менять, Dify обрезает память и найденный контекст гораздо сильнее, чем позволяет модель.
-   **Upper bound for max tokens** по умолчанию тоже 4096. Три модели рассуждают перед ответом, и рассуждения учитываются в этом лимите, так что дайте им запас. 16 000 — наша рекомендация, а не лимит BroadNet.
-   **Token parameter name** со значением `max_tokens` совпадает с полем из справочника API BroadNet. По умолчанию плагин угадывает параметр по имени модели.
-   **API Type** оставьте Chat Completions. Responses API у BroadNet не указан.

## Транскрибация

Плагин умеет добавлять и модели распознавания речи. BroadNet обслуживает `/v1/audio/transcriptions` с `broadnet/cohere-transcribe-arabic` для арабского и `broadnet/cohere-transcribe` для 14 языков. В README плагина сказано, что для speech-to-text он добавляет путь с версией сам, поэтому в его примере указан хост без `/v1` (здесь — `https://inference.broadnet.ai`). Мы не проверяли этот путь через Dify; сначала проверьте его на коротком WAV-файле. См. [руководство по распознаванию арабской речи](https://broadrouter.com/ru/guides/arabic-speech-to-text-api/).

## Решение проблем

-   **Проверка учётных данных не проходит.** Проверьте ключ, API Base URL (для LLM он заканчивается на `/v1`) и имя модели. Для платных моделей нужно пополнить баланс; грант $5 покрывает только `broadnet/gemma-4-26b-a4b`.
-   **Пустые ответы в рабочем процессе.** Max tokens в узле LLM слишком мал для рассуждающей модели. Увеличьте его. [Почему ответы приходят пустыми](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/).
-   **Узел Agent не вызывает инструменты.** Используйте GLM 5.3 или Qwen3.8 27B с Function Call Type = Tool Call.
-   **429 под нагрузкой.** Ключ с оплатой по факту допускает 30 запросов в минуту и 4 одновременно. Параллельные ветки и узлы итерации могут превысить этот лимит; уменьшите их параллелизм. См. [ошибки и повторные запросы](https://broadrouter.com/ru/guides/errors-and-retries/).

## Термины в этом руководстве

[Токен (token)](https://broadrouter.com/ru/glossary/token/)

Токен — это единица текста, которую языковая модель читает и пишет: слово, часть слова, знак препинания или последовательность байтов, которую выдаёт токенизатор модели. LLM API считают, ограничивают и обычно тарифицируют использование в токенах.

[Базовый URL (base URL)](https://broadrouter.com/ru/glossary/base-url/)

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

[Контекстное окно (context window)](https://broadrouter.com/ru/glossary/context-window/)

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

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

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

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

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

[Лимит запросов (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, пока ответ не будет готов.

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

### Работает ли BroadNet в Dify Cloud, а не только в self-hosted Dify?

Да. BroadNet Inference — публичный HTTPS-эндпоинт, поэтому Dify Cloud до него достучится. В документации Dify сказано, что управлять провайдерами моделей могут только владельцы и администраторы рабочего пространства, а добавленный ключ действует во всём пространстве.

### Нужно ли добавлять /v1 в API Base URL?

Да, для моделей LLM. В собственных примерах плагина базовый URL для чат-моделей заканчивается на /v1, а README предупреждает, что для некоторых других типов моделей плагин добавляет путь с версией сам.

### Какой Function Call Type выбрать?

Tool Call для GLM 5.3 и Qwen3.8 27B: для них BroadNet указывает инструменты. Для DeepSeek V4.1 Flash выберите Not Support, если вы сами не проверили на ней вызовы инструментов.

### Тратятся ли AI-кредиты Dify на модели BroadNet?

Нет. Документация Dify говорит, что AI-кредиты не действуют для провайдеров, которыми вы пользуетесь на своём аккаунте. Оплату списывает BroadNet по указанному ключу.

## Похожие руководства

-   [BroadNet Inference в n8n: OpenAI credential и Base URL](https://broadrouter.com/ru/guides/n8n-openai-compatible/)
-   [Как подключить Open WebUI к BroadNet Inference](https://broadrouter.com/ru/guides/open-webui-openai-api/)
-   [Почему рассуждающая модель возвращает пустой ответ](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/)
-   [Коды ошибок BroadNet Inference и когда повторять запрос](https://broadrouter.com/ru/guides/errors-and-retries/)
-   [Все инструменты, которые работают с BroadNet Inference (на английском)](https://broadrouter.com/integrations/): SDK, агенты для программирования, чат-интерфейсы и инструменты автоматизации с точными настройками для каждого

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

[Начать](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-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, плагин OpenAI-API-compatible от langgenius, версия 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)
-   [Справочник API BroadNet Inference (дата обращения 2026-11-15) (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-dify-openai-api-compatible&utm_content=sources)
