Skip to main content
Чтобы подключить Dify к OpenAI API-compatible endpoint BetterToken, установите плагин модели, укажите Base URL https://bettertoken.ai/v1, API Key и точный Model ID.

​
Dify OpenAI API-compatible timeout

При timeout сначала проверьте обычный чат без Agent tools, затем увеличьте timeout в настройках Dify и повторите короткий запрос. Сравните интеграцию с n8n, проверьте правильный Base URL и выберите модель по руководству.

​
Ключевые параметры

​
Подготовка

​
Установка

​
Установка OpenAI-compatible model plugin

1

Откройте Model Providers

В workspace Dify перейдите в Integrations > Model Providers.
2

Установите официальный плагин

Нажмите Install model providers, найдите OpenAI-API-compatible и установите его.Dify управляет model providers как плагинами уровня workspace. После установки приложения с нужными правами смогут выбирать модели этого provider.
3

Добавьте custom model

На карточке OpenAI-API-compatible нажмите Add Model. Если сначала отображается Setup или Configure, откройте этот раздел и выберите добавление модели.

​
Ручная настройка

Выполните эту настройку в интерфейсе провайдеров моделей Dify. Редактировать конфигурационный файл вручную не требуется.

​
Что потребуется

  • Dify Cloud или собственный экземпляр Dify с включёнными плагинами
  • API Key BetterToken (зарегистрироваться)
  • Model ID провайдера GPT из model plaza
  • Права на установку model plugins и управление моделями workspace
Инструкция относится только к LLM Chat. Не добавляйте GPT chat model как Text Embedding, Rerank, Speech-to-Text или Text-to-Speech.

​
Конфигурация модели

Для первой модели заполните поля так:
В API Base URL укажите только https://bettertoken.ai/v1. Не добавляйте /chat/completions: плагин Dify сам вызывает нужный endpoint.
Для остальных возможностей сначала выберите консервативные значения:
  • Thinking Mode Support: включайте только после проверки поддержки моделью
  • Stream function calling: для первого теста выберите Not Support
  • Vision Support: включайте, только если модель и endpoint принимают изображения
  • Structured Output: сначала выключите и проверьте обычный чат
Нажмите Save. Dify проверит API Key, Base URL и ID модели.

​
Использование модели в приложении

1

Создайте или откройте приложение Dify

Откройте Chatbot, Agent, Chatflow или Workflow.
2

Выберите модель

В model selector приложения или в узле LLM выберите модель, добавленную в OpenAI-API-compatible.
3

Сначала проверьте обычный чат

Выполните первый запрос с коротким текстом, без инструментов и изображений:
4

Затем включите возможности Agent

Когда обычный чат заработает, при необходимости измените конфигурацию модели. Укажите в Function Call Type режим, который поддерживает модель. В OpenAI-compatible API обычно используется Tool Call, но поддержку нужно проверять для выбранных модели и endpoint.

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

​
При сохранении возвращается 401

  • Проверьте API Key
  • Убедитесь, что Model ID доступен у провайдера GPT
  • Проверьте статус ключа и баланс в Dashboard BetterToken

​
При сохранении возвращается 404

  • API Base URL должен быть https://bettertoken.ai/v1
  • Не добавляйте /chat/completions
  • Проверьте, что model name for API endpoint полностью совпадает с ID в model plaza

​
Dify сообщает model not found

Model Name влияет на отображение и выбор модели в Dify. В запрос отправляется значение model name for API endpoint. Укажите в обоих полях один и тот же Model ID поддерживаемого провайдера.

​
Обычный чат работает, а инструменты Agent — нет

Верните Function Call Type в Not Support и проверьте базовый узел LLM. Выбирайте Tool Call, только если модель поддерживает вызов инструментов, а затем повторно проверьте их параметры.

​
Knowledge не позволяет выбрать эту модель как Embedding Model

Это ожидаемо: chat LLM не заменяет embedding model. Инструкция не подтверждает наличие у BetterToken embedding или rerank endpoints для Dify. Подключите для Knowledge отдельный поддерживаемый embedding provider.

​
Проверка подключения

Отправьте короткий тестовый запрос. Если инструмент возвращает ответ без ошибок авторизации или Model ID, подключение работает. После изменения конфигурации полностью перезапустите инструмент.

​
Смена модели

Откройте селектор моделей или измените поле Model в конфигурации. Используйте точный Model ID из каталога моделей, затем перезапустите текущую сессию. Dify хранит отдельную custom-конфигурацию для каждого model ID. Чтобы добавить ещё одну модель поддерживаемого провайдера, снова нажмите Add Model в том же provider. Укажите новый ID в Model Name и model name for API endpoint. Base URL и API Key можно использовать повторно.

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

​
Расширенная настройка

​
Поддерживаемые провайдеры

Статусы относятся к способу подключения BetterToken, описанному на этой странице.
  • Ручная настройка: укажите API Key, Base URL и Model.
  • Не поддерживается: проверенный способ прямого подключения пока отсутствует.

​
Связанные материалы

​
Технические детали

В описанном сценарии используется Base URL https://bettertoken.ai/v1. Инструмент сам добавляет путь OpenAI-compatible endpoint. Не добавляйте /chat/completions или /responses к Base URL, если это не требуется конкретным полем.