Dify в России: OpenAI-compatible API и первый workflow

В Dify можно добавить внешний API через официальный model provider OpenAI-API-compatible. Нужны собственный API Key, совместимый Base URL и текущий Model ID. Для проверки соберите workflow из text input, одного LLM node и text output, затем выполните один запуск и сопоставьте результат с записью провайдера.

Для подключения модельного API откройте актуальную инструкцию BetterToken для Dify. Установка Dify, Marketplace, сторонние plugins, agents и tools остаются отдельными слоями.

Что подготовить

Для первого workflow нужен отдельный тестовый ключ. Создайте аккаунт BetterToken и не добавляйте рабочий ключ в экспорт workflow. Создать аккаунт BetterToken

• рабочий Dify Cloud или self-hosted Dify;
• доступ к Integrations/Marketplace и Model Providers;
• собственный BetterToken API Key;
• текущий Model ID из BetterToken model plaza;
• новый тестовый workflow без tools и внешних действий.

Из России к BetterToken API Endpoint можно подключаться без VPN. Это не обещание доступности Dify Cloud, Marketplace, GitHub, Docker registry или сторонних plugins.

1. Установите официальный provider

В Dify откройте Integrations или Marketplace, затем раздел Model Providers. Найдите официальный provider OpenAI-API-compatible и установите его, если он ещё не доступен.

Проверяйте автора и карточку в официальном Dify Marketplace. Не используйте случайный plugin с похожим названием: набор полей и обработка credentials могут отличаться.

2. Добавьте модель BetterToken

Откройте настройки provider и добавьте новую LLM-модель. Заполните:

1. Model Type: LLM.
2. Model Name / ID: точный текущий Model ID.
3. API Key: собственный BetterToken API Key.
4. API Base URL: https://www.bettertoken.ai/v1.
5. Completion mode: Chat, если это требуется выбранным provider и моделью.

Не добавляйте к Base URL /chat/completions: provider формирует полный путь самостоятельно. Не переносите реальные credentials в экспорт приложения, screenshot или issue.

Если UI просит context size, max tokens, vision или streaming-параметры, используйте только значения из текущих документов модели. Для первого теста дополнительные функции не нужны.

3. Сохраните и проверьте credential

Dify валидирует credential при сохранении. Эта проверка подтверждает только то, что provider смог выполнить свою процедуру авторизации. Она ещё не подтверждает весь workflow.

При ошибке сначала сохраните безопасные данные для диагностики:

• название provider и его версия;
• Model ID;
• Base URL без ключа;
• короткий error type и HTTP status;
• время попытки.

Не сохраняйте API Key или полный чувствительный ответ.

4. Создайте минимальный workflow

Создайте новое приложение типа Workflow. Добавьте только три элемента:

1. Start с текстовой переменной question.
2. LLM с добавленной BetterToken-моделью.
3. End с текстом ответа LLM.

В prompt LLM используйте простой шаблон:

Ответь одной строкой. Вход: {{question}}

Соедините Start → LLM → End. Не добавляйте HTTP tools, базу данных, knowledge retrieval, agent loop или публикацию: они затруднят поиск причины первой ошибки.

5. Выполните один тест

Передайте вход:

Верни DIFY_OK и число 4 как сумму 2 + 2.

Успешная настройка подтверждается, когда:

• Dify показывает ожидаемый текстовый output;
• LLM node завершился без credential/model/endpoint error;
• в BetterToken Dashboard появилась запись с ожидаемыми моделью и статусом;
• Dashboard показывает input, output и применимый cache Token, а также соответствующее списание.

Совпадение Dify run и Dashboard помогает исключить ситуацию, когда workflow использовал другой provider или модель.

Как различать ошибки

Provider или plugin не устанавливается

Это слой Dify Marketplace/plugin daemon. В self-hosted окружении проверьте версию Dify, доступ plugin daemon к сети, HTTPS и цепочку сертификатов. Замена API Key BetterToken такую ошибку не исправит.

ToolProviderCredentialValidationError или 401

Повторно введите Key, проверьте пробелы и выбранный provider. Убедитесь, что credential относится к модели, а не к unrelated tool plugin.

404

Проверьте Base URL:

https://www.bettertoken.ai/v1

Удалите добавленный вручную /chat/completions, если поле ожидает API Base URL.

model not found

Скопируйте текущий ID из model plaza. Проверьте, что этот ID доступен для созданного Key и выбранного OpenAI-compatible provider.

Credential сохраняется, но workflow падает

Проверьте LLM node отдельно. Уберите tools, streaming и structured output, затем повторите короткий text-in/text-out запуск. Если он проходит, возвращайте дополнительные узлы по одному.

Граница этой настройки

Первый workflow подтверждает модельный запрос через официальный OpenAI-API-compatible provider. Он не доказывает совместимость каждого Dify agent, community plugin, tool или внешнего сервиса. Для действия с побочным эффектом создавайте отдельный тест и добавляйте явное подтверждение пользователя.

Актуальные поля и ограничения находятся в BetterToken Docs для Dify. Dynamic Model ID и цены всегда сверяйте в день настройки. Сам provider OpenAI-API-compatible и его поля API Key, Model Name и API Base URL опубликованы в официальном репозитории plugins Dify.