Dify и LLM API из России: подключаем Hubris как OpenAI-совместимый провайдер

Dify — это open-source платформа для создания приложений на базе нейросетей: чат-боты, RAG-пайплайны с поиском по документам, AI-агенты и автоматизация рабочих процессов. Она работает с любым OpenAI-совместимым API, а значит, все 563 модели из каталога Hubris доступны в Dify с оплатой в рублях — через СБП, банковскую карту или счёт для юридических лиц.

Что такое Dify AI и зачем подключать его к внешнему API

Dify (часто ищут как «Dify AI») — это визуальный конструктор рабочих процессов: перетаскиваете узлы — «LLM», «Retrieval», «Code», «HTTP» — и собираете пайплайн без единой строки кода. Платформа выложена с открытым исходным кодом на GitHub и доступна в двух вариантах: самостоятельная установка на своём сервере (Dify Community Edition) и облачный сервис (Dify Cloud). Маркетплейс Dify предлагает готовые шаблоны чат-ботов, RAG-систем и агентов, которые можно развернуть за пару кликов.

По умолчанию платформа предлагает встроенных провайдеров (OpenAI, Anthropic, Google), но все они требуют зарубежной карты. Hubris — российский API-шлюз, который принимает запросы в формате OpenAI и позволяет оплачивать использование нейросетей в рублях. Подключив Hubris как кастомный провайдер, вы получаете в Dify доступ к 563 моделям: DeepSeek-V3 (от 30 ₽/млн токенов), Qwen3.6-27B (от 50 ₽/млн), Claude Haiku 4.5 (от 112 ₽/млн) и другим.

Как скачать и установить Dify

Dify можно развернуть на своём сервере за 10 минут — исходный код опубликован на GitHub в репозитории langgenius/dify. Есть три основных способа установки:

• Docker Compose — рекомендуемый способ для продакшена. Клонируйте репозиторий (git clone https://github.com/langgenius/dify.git), перейдите в каталог docker/ и выполните docker compose up -d. Вместе с Dify поднимутся PostgreSQL, Redis и Weaviate (векторная база данных).
• Установка через Kubernetes — в репозитории есть готовый Helm-чарт для масштабируемого деплоймента, подходит для команд с действующим Kubernetes-кластером.
• Dify Cloud — облачная версия (cloud.dify.ai), не требующая установки: регистрируетесь и сразу начинаете работу. Подробнее о сравнении Cloud и self-hosted — в следующем разделе.

После установки Dify доступен по адресу http://localhost:3000 (или http://localhost при установке через Docker) и готов к настройке провайдера.

Dify Cloud или свой сервер: что выбрать

Выбор между облаком и собственным сервером зависит от трёх факторов:

Критерий	Dify Cloud	Свой сервер (self-hosted)
Время запуска	Мгновенно, после регистрации	10–20 минут на установку
Стоимость	Бесплатный тариф на 200 запросов, далее от $59/мес	Только стоимость VPS (от 500 ₽/мес)
Контроль данных	Данные на серверах Dify	Данные полностью под вашим контролем
Обновления	Автоматически	Вручную через git pull

Рекомендация: для теста и небольших проектов — Dify Cloud с бесплатным тарифом. Для продакшена с чувствительными данными — самостоятельная установка на своём сервере. Hubris работает с обоими вариантами одинаково: настройка провайдера в Cloud и self-hosted версии идентична.

Настройка провайдера в Dify: шаг за шагом

Для работы нужен API-ключ Hubris формата sk-gw-... — создаётся после регистрации на hubris.pw.

1. Откройте настройки модели

В интерфейсе Dify перейдите: «Settings» → «Model Provider» → «OpenAI-Compatible». Нажмите «Add Model».

2. Заполните поля подключения

Поле	Значение
Model Name	Любое удобное, например deepseek-v3
API Key	Ваш ключ sk-gw-... из личного кабинета Hubris
API Endpoint URL	https://api.hubris.pw/v1
Model type	LLM

В поле «Model Name» вводите идентификатор модели из каталога Hubris — например deepseek/deepseek-v3.2 или qwen/qwen3.6-27b.

3. Проверьте соединение

Нажмите «Save» — Dify отправит тестовый запрос. Если конфигурация верна, рядом появится зелёная галочка.

4. Выберите модель по умолчанию

В «System Model Settings» установите добавленную модель как провайдера для диалогов и эмбеддингов. Для эмбеддингов подойдёт baai/bge-m3 — он тоже доступен через Hubris.

Dify и n8n: в чём разница и как работают вместе

И Dify, и n8n — инструменты для автоматизации с нейросетями, но задачи у них разные:

• Dify — специализированная платформа для LLM-приложений: построение RAG-пайплайнов, управление базой знаний, визуальный конструктор промптов. Dify «думает» о контексте, чанках и векторном поиске.
• n8n — универсальный инструмент автоматизации рабочих процессов: соединяет CRM, почту, базы данных и внешние API в единые цепочки. Нейросети для n8n — один из сотен узлов.

Как Dify и n8n работают вместе: типовая связка — n8n собирает данные из внешних источников (почта, Telegram, Notion) и передаёт их в Dify через HTTP-запрос. Dify обрабатывает запрос с помощью LLM и возвращает ответ, а n8n отправляет его конечному получателю. Подробнее о подключении нейросети к n8n — в статье «Нейросеть в n8n: пошаговое руководство».

Создание первого чат-бота в Dify

После настройки провайдера создайте приложение:

1. «Create App» → «Chatbot» → «Basic».
2. В блоке «Orchestrate» выберите модель — вашу только что добавленную через Hubris.
3. Задайте системный промпт, нажмите «Publish».

Готово — у вас работающий чат-бот, который обращается к нейросети через российский шлюз. Оплата в рублях, пополнение баланса от 500 ₽ через СБП, банковскую карту или счёт для юридических лиц.

RAG-пайплайн с базой знаний

Dify умеет автоматически разбивать документы на чанки, строить эмбеддинги и хранить их в векторной базе. Это ключевая возможность платформы — RAG (Retrieval-Augmented Generation) позволяет чат-боту отвечать на вопросы о ваших документах, а не только на основе знаний модели.

Как подключить эмбеддинги через Hubris:

В «Model Provider» добавьте ещё одну модель с теми же реквизитами, но укажите тип «Text Embedding» и идентификатор baai/bge-m3 — многоязычная модель с поддержкой русского языка.

После этого в «Knowledge» создайте базу знаний: загрузите PDF или текстовые файлы, настройте параметры чанкинга (размер фрагмента, перекрытие), выберите embedding-модель и нажмите «Save & Process». Dify автоматически проиндексирует документы через Hubris. Чат-бот с доступом к базе знаний отвечает на вопросы о ваших документах точнее, чем универсальная LLM.

Подробнее об эмбеддинговых моделях — в статье «Эмбеддинги и семантический поиск: практический гайд».

Автоматизация через API и другие инструменты

Если Dify используется в составе более широкой автоматизации, его можно интегрировать через HTTP-запросы. Сам Hubris также работает как узел в n8n-пайплайнах, подключается к LangChain и Python-проектам и работает с любым инструментом, поддерживающим OpenAI API по адресу https://api.hubris.pw/v1.

Маркетплейс Dify: готовые шаблоны и плагины

В маркетплейсе Dify (раздел «Explore» в левом меню) собраны готовые приложения от сообщества — от чат-ботов службы поддержки до AI-помощников для написания кода. Каждый шаблон можно установить в один клик как DSL-файл и сразу адаптировать под свои задачи:

• Чат-бот с базой знаний — отвечает на вопросы клиентов по вашей документации;
• Генератор SEO-текстов — создаёт статьи по структуре и ключевым словам;
• AI-ассистент программиста — анализирует код и предлагает исправления.

Для использования любого шаблона с Hubris достаточно заменить модель в настройках на добавленного кастомного провайдера.

Какие модели выбрать для Dify

Выбор зависит от задачи:

• Диалоги и инструкции — DeepSeek-V3 (30 ₽/млн вх. / 45 ₽ исх.) хорошо соотносит цену и качество.
• Код и технические задачи — Qwen3.6-27B (32 ₽ / 269 ₽), поддерживает функции.
• Сложные рассуждения — Claude Haiku 4.5 (112 ₽ / 560 ₽) для задач, где нужна точность.
• Эмбеддинги — BAAI/BGE-M3 (поддерживает русский язык).

Полный прайс — в каталоге моделей. Там же можно сравнить параметры и проверить наличие функции tool_calls.

Частые вопросы

Что такое Dify AI? Dify AI — это open-source платформа для создания приложений с нейросетями: чат-боты, RAG-системы для поиска по документам, AI-агенты. Работает через визуальный конструктор без программирования, поддерживает любой OpenAI-совместимый API.

Как установить Dify с нуля? Три способа: Docker Compose (основной — клонировать репозиторий с GitHub и запустить docker compose up -d), Kubernetes (Helm-чарт из репозитория) или Dify Cloud (регистрация на cloud.dify.ai без установки). Пошаговая инструкция — в разделе «Как скачать и установить Dify».

Dify работает только с OpenAI или с другими провайдерами тоже? Dify поддерживает любой OpenAI-совместимый эндпоинт через тип провайдера «OpenAI-Compatible». Hubris именно такой шлюз — стандарт Chat Completions полностью соблюдён.

Dify Cloud или самостоятельный хостинг — что лучше? Для теста и небольших проектов — Dify Cloud (бесплатный тариф на 200 запросов). Для продакшена с конфиденциальными данными — свой сервер (данные полностью под вашим контролем). Hubris работает с обоими вариантами одинаково.

Чем Dify отличается от n8n? Dify заточен под LLM-приложения: RAG, базы знаний, визуальный конструктор промптов. n8n — универсальный автоматизатор, соединяющий десятки сервисов. Они не конкурируют, а дополняют друг друга: n8n собирает данные, Dify обрабатывает их с помощью нейросетей.

Можно ли использовать стриминг (streaming) в Dify через Hubris? Да. Hubris передаёт Server-Sent Events в точном соответствии со спецификацией OpenAI, Dify корректно отображает ответ в реальном времени.

Есть ли ограничение на количество запросов? Ограничения по токенам нет — вы платите только за фактическое использование. На новом аккаунте действует небольшой дневной лимит для защиты от злоупотреблений; снимается при пополнении баланса.