Как добавить OpenAI, Claude, Gemini и DeepSeek в Dify

Что вы создадите

Какой сервис API позволяет добавить больше моделей ИИ в Dify без отдельной настройки каждого провайдера? CometAPI — один из практических вариантов. Установите его плагин моделей для Dify один раз, сохраните один ключ CometAPI и используйте модели от OpenAI, Anthropic, Google и DeepSeek в одном рабочем пространстве Dify.

Один ключ — не значит одна конфигурация модели: CometAPI централизует аутентификацию и доступ к API, но Dify по‑прежнему должен знать, какую модель должен вызывать каждый узел LLM. Поэтому вы можете настроить несколько ID моделей в рамках одного подключения провайдера.

К концу этого руководства у вас будут доступны четыре текстовые модели в Dify под одним подключением провайдера. У вас также будет небольшой Python smoke‑тест, который использует тот же endpoint и ключ вне Dify — это упрощает отделение проблемы конфигурации Dify от проблемы на стороне API.

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

Прежде чем начать

Вам нужно рабочее пространство Dify с возможностью установки плагинов моделей, ключ API CometAPI и актуальные ID моделей. Храните ключ в хранилище учетных данных Dify или в секретах на стороне сервера; не размещайте его в публичном репозитории, браузерном бандле, на скриншоте или в общем экспортируемом workflow.

OpenAI‑совместимый базовый URL — https://api.cometapi.com/v1. Плагин CometAPI для Dify настраивает эту конечную точку внутренне. Если вы используете в Dify универсальный провайдер, совместимый с OpenAI API, введите тот же базовый URL вручную.

Можно ли добавить несколько моделей ИИ в Dify с одним ключом API?

Да. Подключение провайдера CometAPI позволяет Dify повторно использовать одни учетные данные для поддерживаемых моделей от OpenAI, Anthropic, Google, DeepSeek и других провайдеров. При этом вы по‑прежнему настраиваете каждый ID модели отдельно, чтобы каждый узел LLM знал, какой маршрут вызывать, но вам не нужно поддерживать разные учетные данные и биллинговые аккаунты для каждого семейства моделей.

Зачем использовать CometAPI вместо прямого подключения каждого провайдера?

CometAPI сокращает интеграционные накладные расходы, предоставляя совместимым чат‑нагрузкам один базовый URL, один ключ API и одну учетную запись использования. Это упрощает оценку и переключение моделей внутри Dify при сохранении видимости модель‑специфичных решений. Прямые подключения к провайдерам могут оставаться предпочтительными, когда вам нужна функция, контракт, региональное развертывание или поддержка, доступные только у конкретного провайдера, поэтому протестируйте точные возможности модели, необходимые вашему workflow.

Какие модели можно добавить в Dify?

Текущие ID и даты публикации CometAPI выше были проверены по публичному каталогу API 26 августа 2026 года. Используйте каждую связанную страницу модели CometAPI как динамический источник цен вместо копирования тарифа, который может устареть. Доступность, модальности и поддержка плагина Dify также могут меняться, поэтому подтвердите точную модель в вашем аккаунте перед развертыванием.

Как подключить CometAPI к Dify

Шаг 1 — Установите плагин моделей CometAPI

Откройте раздел Marketplace или Plugins в Dify и найдите CometAPI. Установите плагин провайдера моделей CometAPI. Конкретные названия пунктов навигации могут отличаться между Dify Cloud и self‑hosted версиями, поэтому используйте актуальный экран конфигурации плагина вместо того, чтобы полагаться на фиксированный путь в меню.

Шаг 2 — Настройте провайдера CometAPI

Откройте актуальный экран конфигурации плагина CometAPI, вставьте ваш ключ CometAPI и сохраните учетные данные провайдера. Dify может проверить его с помощью небольшого запроса к модели. Плагин направляет совместимые чат‑нагрузки через https://api.cometapi.com/v1, поэтому вам не нужны отдельные учетные данные OpenAI, Anthropic, Google и DeepSeek.

Если ваше развертывание Dify не может установить плагин CometAPI, установите официальный провайдер моделей OpenAI-API-compatible. Добавьте каждую модель как LLM в режиме Chat, повторно используйте тот же ключ CometAPI и установите API Base URL на https://api.cometapi.com/v1. Этот запасной путь потребует создать одну пользовательскую запись на модель, но по‑прежнему избавит от отдельных аккаунтов у провайдеров.

Шаг 3 — Добавьте четыре ID модели

Вернитесь к провайдеру CometAPI и найдите четыре ID в списке моделей. Если ID уже предопределен — включите его. Если он еще не виден в вашей версии установленного плагина, выберите опцию кастомной модели у провайдера и введите точный текущий ID из таблицы выше. Оставьте Completion mode в положении Chat.

Когда Dify запрашивает размер контекста для кастомной модели, используйте проверенное значение, а не предполагаемое по умолчанию. Для мультимодальных переключателей включайте только те возможности, которые указаны в живом каталоге. Модель может поддерживать Chat Completions, не поддерживая изображения, инструменты, структурированный вывод или элементы управления рассуждением так же, как другая модель.

Шаг 4 — Выберите модель в вашем приложении Dify

Откройте Chatflow, Workflow, Agent или чат‑бот в Dify Studio. Добавьте узел LLM, выберите CometAPI как провайдера и выберите один из настроенных ID модели. Используйте короткий промпт вроде “Ответьте одним предложением с указанием семейства модели”, затем выполните узел. Повторите с тремя другими моделями. Меняется только выбранный ID модели; учетные данные провайдера остаются теми же.

Как проверить подключение с помощью Python

Используйте этот автономный smoke‑тест, чтобы проверить те же четыре маршрута до вовлечения Dify. Установите OpenAI Python SDK, сохраните COMETAPI_KEY в переменных окружения и запустите скрипт с доверенной машины. Успешный результат подтверждает ключ, endpoint и текущие ID моделей; он не заменяет тестирование внутри реального workflow в Dify.

import osfrom openai import OpenAI​MODELS = {    "OpenAI": "gpt-5.6",    "Claude": "claude-opus-5",    "Gemini": "gemini-3.7-flash",    "DeepSeek": "deepseek-v4-flash",}​client = OpenAI(    api_key=os.environ["COMETAPI_KEY"],    base_url="https://api.cometapi.com/v1",    timeout=30.0,    max_retries=2,)​for family, model in MODELS.items():    try:        response = client.chat.completions.create(            model=model,            messages=[                {"role": "user", "content": "Reply with one short sentence."}            ],        )        text = response.choices[0].message.content or ""        print(f"{family}: OK | {response.model} | {text[:80]}")    except Exception as error:        print(f"{family}: ERROR | {type(error).__name__} | {error}")

Держите этот тест вне вашего workflow в Dify. Его задача — подтвердить ключ, endpoint и ID модели. Как только модель успешно проходит здесь, сбой в Dify, вероятнее всего, связан с конфигурацией плагина, настройками возможностей модели или самим workflow.

Как проверить доступность модели перед развертыванием

Вы можете проверить доступность модели через актуальный каталог моделей CometAPI или Models API перед развертыванием. Убедитесь, что точный ID модели присутствует в вашем аккаунте, затем выполните небольшой аутентифицированный запрос перед добавлением в production‑workflow Dify.

С вашим ключом успешный не‑streaming‑вызов возвращает объект Chat Completions. Сгенерированная формулировка может отличаться, но ответ должен содержать следующие поля:

{  "id": "chatcmpl-...",  "object": "chat.completion",  "model": "the-routed-model-id",  "choices": [    {      "index": 0,      "message": {        "role": "assistant",        "content": "..."      },      "finish_reason": "stop"    }  ],  "usage": {    "prompt_tokens": 0,    "completion_tokens": 0,    "total_tokens": 0  }}

В Dify эквивалентный сигнал успеха — завершенный узел LLM с текстом на панели вывода. Проверьте run logs Dify для выбранной модели, затраченное время, использование токенов и любую нормализованную ошибку провайдера.

Как выбрать подходящую модель для Dify

Начинайте с рабочей нагрузки, а не с названия провайдера. Используйте передовую модель для сложных рассуждений, работы с большими кодовыми базами или ответов высокой ценности; выбирайте более быструю модель для интерактивного чата и повторяющихся шагов workflow; и используйте более дешевую текстовую модель для классификации, извлечения и других ограниченных задач. Сравнивайте модели с одним и тем же набором промптов и записывайте качество ответов, задержку, использование токенов, поведение инструментов и стоимость на успешный запуск. Также убедитесь, что выбранный маршрут поддерживает все необходимые входы и функции. Общее подключение CometAPI упрощает переключение, но не делает одинаковыми лимиты контекста, мультимодальные входы, инструменты, структурированный вывод или элементы управления рассуждением у разных моделей.

Типичные сценарии неполадок и решения

Dify отклоняет учетные данные с 401. Скопируйте ключ заново из панели CometAPI и удалите пробелы в начале и конце. Не включайте слово Bearer в поле API Key в Dify; плагин формирует заголовок авторизации.

Универсальный провайдер возвращает 404 или HTML. Используйте полный базовый URL https://api.cometapi.com/v1. Пропуск /v1 или добавление /chat/completions к базовому URL в Dify может привести к неверному конечному пути.

Модель не появляется в Dify. Обновите плагин CometAPI, затем сравните ID с актуальным каталогом. Если текущий ID не предопределен, добавьте его как кастомную модель в рамках того же провайдера CometAPI. Не подменяйте на похожее по виду название модели.

Текстовый запрос работает, но изображения или инструменты — нет. Совместимость с OpenAI описывает поверхность запроса, а не идентичное поведение модели. Перепроверьте заявленные модальности модели и настройки плагина для vision, вызова инструментов, структурированного вывода и рассуждений.

Запрос превышает окно контекста. Подтвердите размер контекста кастомной модели в Dify, укоротите извлекаемые документы и историю диалога и оставьте место под вывод. Большой контекст в каталоге не снимает ограничения workflow Dify или провайдер‑специфичных правил по токенам.

Вы получаете 429 или периодические 5xx ошибки. Повторяйте 429, таймауты и временные ошибки сервера с экспоненциальной задержкой и джиттером. Не выполняйте автоматические повторы для ошибок аутентификации, неверной модели или некорректного запроса.

Примечания для продакшена

Храните секреты на стороне сервера. Используйте отдельные ключи CometAPI для разработки и продакшена, задавайте разумные квоты, ротируйте скомпрометированные ключи и избегайте экспорта реальных учетных данных с приложениями Dify.

Зафиксируйте протестированный ID модели. Не заменяйте модель незаметно только потому, что в каталоге появилась новая. Возможности, задержка, стиль вывода и цена могут меняться между версиями даже у одного провайдера.

Измеряйте по маршруту. Записывайте ID модели, задержку, использование токенов, код ошибки и версию приложения Dify для каждого продакшен‑вызова. Это позволит сравнивать модели и исследовать изменения стоимости без опоры на субъективные впечатления.

Проектируйте фолбэк по возможностям. Используйте более дешевую модель для рутинного трафика и более сильную — для эскалации, но совмещайте только модели, поддерживающие одинаковые входы и необходимые инструменты. Повторяйте временные сбои перед переключением моделей, ограничьте общий бюджет задержки и тестируйте каждый резервный маршрут. См. руководство CometAPI по фолбэку моделей: model fallback guide.

Перепроверяйте цены перед запуском. Тарифы в этой статье — снимок на определенную дату, а не контракт. Ознакомьтесь с pricing guide и актуальным каталогом моделей перед установкой бюджета или публикацией заявлений о стоимости.

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

Как добавить OpenAI в Dify через CometAPI?

Установите плагин провайдера моделей CometAPI, сохраните ваш ключ CometAPI и добавьте gpt-5.6 как выбираемую модель LLM. Выберите режим Chat, когда Dify запросит режим Completion, затем запустите короткий текстовый промпт перед включением модели в production‑workflow. Текущий каталог CometAPI перечисляет маршрут для совместимых чат и Responses рабочих нагрузок, но поддержка в плагине Dify может различаться по версиям. Если ID не предопределен, обновите плагин или используйте его опцию кастомной модели. Оставьте общие учетные данные провайдера неизменными и отдельно проверьте настройки для ввода изображений, вызова инструментов, структурированного вывода и рассуждений перед тем, как полагаться на них.

Как добавить Claude в Dify через CometAPI?

В рамках того же подключения провайдера CometAPI добавьте claude-opus-5 как отдельную модель LLM и выберите ее в узле Dify, где нужен Claude. Текущий каталог CometAPI документирует для этой модели и маршрут Anthropic Messages, и OpenAI‑совместимый чат‑маршрут. Dify по‑прежнему нужен собственный ввод модели, потому что ID Claude, поддерживаемые входы, лимиты токенов и поведение отличаются от маршрута OpenAI. Протестируйте один простой ответ и одну репрезентативную длительную или с инструментами задачу, затем проверьте run log Dify на предмет фактической модели, задержки, использования токенов и нормализованных ошибок перед тем, как назначать ее по умолчанию.

Как добавить Gemini в Dify через CometAPI?

Добавьте gemini-3.7-flash в рамках существующего провайдера CometAPI, затем выберите этот вариант в соответствующем узле LLM в Dify. CometAPI в настоящее время перечисляет и родной маршрут Gemini generating-content, и OpenAI‑совместимый чат‑маршрут. Для базового чат‑workflow в Dify начните с текстового режима и подтвердите успешный запуск, прежде чем тестировать изображения, PDF, аудио или видео. Эти модальности могут зависеть от версии плагина и конфигурации узла, даже если они указаны в каталоге модели. Держите Gemini отдельной конфигурацией модели, чтобы задать подходящие лимиты и сравнить ее скорость, качество и стоимость с другими маршрутами.

Как добавить DeepSeek в Dify через CometAPI?

Создайте отдельную запись модели в Dify для deepseek-v4-flash, повторно используя те же учетные данные провайдера CometAPI. Текущий каталог CometAPI перечисляет этот маршрут для текст‑к‑тексту чат‑нагрузок, поэтому не копируйте настройки изображений из конфигураций OpenAI, Claude или Gemini. Сначала протестируйте короткий текстовый промпт, затем — задачу по кодированию или рассуждению, которую вы планируете запускать. Если модель отсутствует в Dify, обновите плагин или добавьте точный текущий ID через опцию кастомной модели. Перед маршрутизацией продакшен‑трафика перепроверьте живую страницу модели на предмет динамического ценообразования и доступности.

Можно ли использовать OpenAI, Claude, Gemini и DeepSeek в одном workflow Dify?

Да. Каждый узел LLM может использовать другого провайдера/конфигурацию модели. С CometAPI поддерживаемые модели могут делить одни и те же учетные данные провайдера, в то время как workflow выбирает разные ID моделей.

Может ли один ключ CometAPI действительно покрывать OpenAI, Claude, Gemini и DeepSeek в Dify?

Да. Плагин моделей CometAPI для Dify хранит одни учетные данные провайдера и использует их для поддерживаемых моделей этих семейств. Вы по‑прежнему выбираете или добавляете каждый ID модели, чтобы Dify знал, какую модель вызывать.

Нужно ли вводить базовый URL CometAPI в Dify?

Нет, если вы используете специализированный плагин CometAPI; он задает https://api.cometapi.com/v1 внутренне. Вводите этот базовый URL вручную только при использовании универсального провайдера моделей Dify, совместимого с OpenAI API.

Поддерживает ли Dify Claude через OpenAI‑совместимый API?

Dify может работать с провайдерами, совместимыми с OpenAI, но совместимость не делает поведение API Claude идентичным OpenAI. Проверьте поддерживаемые параметры и возможности модели перед включением инструментов, структурированного вывода, vision или функций, специфичных для рассуждений.

Могу ли я использовать одинаковые настройки Dify для каждой модели?

Нет. Endpoint и ключ могут быть общими, но лимиты контекста, модальности, поддержка инструментов, параметры рассуждений, задержка и цены остаются специфичными для каждой модели. Рассматривайте каждое сопоставление модели как протестированную конфигурацию.

Какую модель сделать по умолчанию?

Решайте после тестирования собственных промптов. Дешевая модель может справляться с рутинной классификацией или переписыванием, а более сильная — с сложными рассуждениями или ответами высокой ценности. Избегайте универсального утверждения «лучшая» без данных по рабочей нагрузке.

Заключение

CometAPI позволяет рабочему пространству Dify использовать OpenAI, Claude, Gemini и DeepSeek через одни учетные данные провайдера и единый API‑endpoint для совместимых чат‑нагрузок. Настройка проста: установите плагин моделей, сохраните ключ, сопоставьте текущие ID моделей и протестируйте каждый маршрут. Операционные задачи остаются модель‑специфичными — возможности, контекст, цены и поведение фолбэка следует проверять, а не предполагать.