# Dify

Dify подключает любой OpenAI-совместимый сервис через провайдера моделей OpenAI-API-compatible. Каждая модель добавляется отдельно, и несколько настроек по умолчанию нужно изменить.

> https://nezhagate.com/ru/docs/integrations/dify

Проверено на версии Dify 1.17 · OpenAI-API-compatible 0.0.68

## Перед началом

- Аккаунт владельца рабочего пространства или администратора — настраивать провайдеров моделей могут только они.

- Установите **OpenAI-API-compatible** (официальный плагин langgenius) из Marketplace.

## Добавьте модель

Откройте **Model Provider** (в новых версиях — в разделе Integrations, в старых — в Settings), нажмите **Add Model** на карточке OpenAI-API-compatible и заполните форму, как показано ниже:

| Поле | Что вписать |
| --- | --- |
| **Model Type** | LLM |
| **Model Name** | Точный ID модели, например `gpt-5.5` |
| **API Key** | Ваш API-ключ NezhaGate |
| **API Base URL** | `https://nezhagate.com/v1` |
| **Completion mode** | Chat |
| **Model context size** | Реальная длина контекста модели (см. её документацию по API). **По умолчанию — 4096**: если оставить как есть, длинные диалоги будут обрываться. |
| **Upper bound for max tokens** | Максимум выходных токенов модели; по умолчанию тоже 4096. |
| **Function Call Type** | **Tool Call** — для моделей с вызовом инструментов. Значение по умолчанию, Not Support, не даёт агентам вызывать инструменты. |
| **Vision Support** | Support — для моделей, которые принимают изображения на вход. |
| **API Type** | Оставьте **Chat Completions API**. |

В адресе обязательно должен быть `/v1`: плагин сам добавляет к нему `/chat/completions`. Остальные поля оставьте по умолчанию.

## Claude (необязательно)

Можно также установить официальный плагин **Anthropic**, указать в **API URL** значение `https://nezhagate.com/anthropic` и добавлять модели Claude по одной через **Add Model** (например, `claude-sonnet-5`).

## Проверка

При сохранении отправляется один очень короткий запрос для проверки (оплачивается по фактическому минимальному расходу). Затем создайте чат-бота в **Studio**, выберите модель и отправьте сообщение в режиме предпросмотра.

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

**Credentials validation failed with status code 404**

В адресе не хватает `/v1`; должно быть `https://nezhagate.com/v1`.

**Проверка возвращает 401 или model not found**

401 означает, что ключ неверный; model not found — что ID модели написан с ошибкой. Берите ID из [справочника API](https://nezhagate.com/ru/docs/api).

**Агент никогда не вызывает инструменты**

В форме модели параметр **Function Call Type** всё ещё стоит на Not Support — переключите на Tool Call.

**Длинные ответы или диалоги обрываются**

**Model context size** и **Upper bound for max tokens** всё ещё равны 4096 — увеличьте их до реальных значений модели.