К содержимому

Dify API: подключение и настройка моделей

В Dify шлюз подключается плагином OpenAI-API-compatible: адрес с /v1, ключ, имя модели и размер контекста.

  • Тип: No-code платформа
  • Протокол: OpenAI Chat Completions
  • Статус: Работает
Настройки сверены с официальной документацией клиента, 2026-10-02. Не проверено вручную: запуск клиента против шлюза не выполнялся.

Что заработает

ВозможностьОтметкаПримечание
ЧатДа
Потоковый ответДа
Вызов инструментовЧастичноВключите вызов функций в настройках модели.
ЭмбеддингиНетУ шлюза нет /v1/embeddings: модель эмбеддингов подключайте у другого провайдера.

Настройка

Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.

  1. Откройте Integrations, Model Provider и установите плагин OpenAI-API-compatible.
  2. В Setup введите имя модели из каталога (gpt-5.6-luna), ключ и API Base URL https://relay-llm.ru/v1.
  3. Поднимите Model context size до значения из каталога и включите вызов функций, если модель его поддерживает.

Поля модели

text
Model Name: gpt-5.6-luna
API Key: YOUR_API_KEY
API Base URL: https://relay-llm.ru/v1
Model context size: 128000
Function calling: Supported

Проверка

Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.

macOS и Linux

bash
curl https://relay-llm.ru/v1/key \
  -H "Authorization: Bearer $RELAY_API_KEY"

Windows PowerShell

bash
curl.exe https://relay-llm.ru/v1/key `
  -H "Authorization: Bearer $env:RELAY_API_KEY"

Windows cmd

bash
curl https://relay-llm.ru/v1/key ^
  -H "Authorization: Bearer %RELAY_API_KEY%"

Затем проверьте сам клиент.

Создайте простое приложение-чат, выберите модель и отправьте «ping». Запись видна в журнале запросов кабинета.

Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.

Ограничения протоколов

OpenAI Chat Completions

Работают чат-модели каталога по пути /v1/chat/completions. Не поддерживаются /v1/embeddings, /v1/audio/*, /v1/moderations, /v1/batches, Assistants и Realtime: функции клиента, которым они нужны, не заработают.

Ловушки

  • Размер контекста по умолчанию 4096. Поднимите вручную, иначе длинные запросы будут обрезаться.
  • Без флага вызова функций агенты не вызывают инструменты.
  • Режим Anthropic в Dify отдельный плагин с полем API URL: адрес без /v1. Эту связку мы не проверяли.

Официальная документация: Dify API: подключение и настройка моделей

Подключение клиентов: общие сведения и все клиенты

Обработка ошибок и повторы

Модели и ключ: список моделей в API

Ключи в кабинете

Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key