> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Подключение Dify к CometAPI

> Используйте это руководство, чтобы подключить Dify к CometAPI, указав base URL, API key и параметры model или provider.

[Dify](https://dify.ai) — это open-source платформа для разработки LLM-приложений. Подключив ее к CometAPI, вы сможете использовать актуальные model ID CometAPI в конструкторах workflow, chatbot и agent внутри Dify.

## Предварительные требования

* Учетная запись CometAPI с активным API key — [войдите, чтобы получить его](https://www.cometapi.com)
* Учетная запись Dify — [облачная](https://cloud.dify.ai/signin) или self-hosted

## Способ 1: плагин CometAPI (рекомендуется)

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

<Steps>
  <Step title="Получите свой CometAPI API key">
    Войдите в [панель управления CometAPI](https://www.cometapi.com/console). Нажмите **Add API Key** и скопируйте свой ключ.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Панель управления CometAPI с кнопкой Add API Key и списком ключей" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="Сведения об API key CometAPI с base URL https://api.cometapi.com" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Установите плагин CometAPI в Dify">
    В Dify перейдите в **Plugins** → **Install Plugin** → **Marketplace**. Найдите `cometapi` и установите его.

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_360267.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=85e4b1a60c912aa98c182ed731cde19f" alt="Результаты поиска в marketplace плагинов Dify с плагином CometAPI" width="1875" height="916" data-path="images/integrations/810968_360267.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_360269.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=695d0f5fde8d4c8aad398048b3b504fd" alt="Диалог подтверждения установки плагина CometAPI в Dify" width="1865" height="896" data-path="images/integrations/810968_360269.png" />
    </Frame>
  </Step>

  <Step title="Добавьте свой API key">
    Перейдите в **Settings** → **Model Provider** → **CometAPI** → **Open Settings**. Вставьте свой CometAPI API key и нажмите **Save**.
  </Step>

  <Step title="Добавьте модели">
    Введите model ID со страницы [CometAPI Models](/ru/overview/models) и нажмите **Add**.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_362636.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=9aee58e6532ba58d69eb7673e6c45293" alt="Настройки model provider в Dify с формой конфигурации CometAPI" width="1256" height="880" data-path="images/integrations/810968_362636.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_362637.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=46c8b360d87cfad2adc1cd9f18dd7f25" alt="Список моделей в Dify с успешно добавленными моделями CometAPI" width="1935" height="870" data-path="images/integrations/810968_362637.png" />
    </Frame>
  </Step>

  <Step title="Проверьте подключение">
    Создайте chatbot или workflow и выберите модель CometAPI. Отправьте тестовое сообщение — успешный ответ подтверждает, что интеграция работает.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_362638.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=c729bbc0f3bef82a89305434c08ec313" alt="Интерфейс чата Dify с успешным ответом от модели CometAPI" width="1910" height="924" data-path="images/integrations/810968_362638.png" />
    </Frame>
  </Step>
</Steps>

## Способ 2: OpenAI-compatible provider

Используйте этот способ, чтобы добавлять модели, которые не поддерживаются плагином CometAPI, например Claude, Grok или Gemini, — либо чтобы использовать пользовательские имена моделей.

<Steps>
  <Step title="Откройте настройки model provider">
    Перейдите в **Settings** → **Model Provider** → **OpenAI-API-compatible** → **Add Model**.
  </Step>

  <Step title="Настройте модель">
    Заполните следующие поля:

    | Поле         | Значение                                          |
    | ------------ | ------------------------------------------------- |
    | Тип модели   | LLM                                               |
    | Имя модели   | Model ID из CometAPI (должен полностью совпадать) |
    | API key      | Ваш CometAPI API key                              |
    | API base URL | `https://api.cometapi.com/v1`                     |

    Нажмите **Save**.

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_354447.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=a6752a58cf43a3c7658da7b276ed5c1e" alt="Форма OpenAI-compatible provider в Dify с заполненными значениями CometAPI" width="1910" height="1009" data-path="images/integrations/810968_354447.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_354448.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=18caf18d11f4f0aa6741471016bcb14f" alt="Список моделей в Dify с новой сохраненной записью CometAPI-compatible модели" width="1953" height="965" data-path="images/integrations/810968_354448.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Идентификаторы моделей смотрите на странице [CometAPI Models](/ru/overview/models). Model ID в Dify должен в точности совпадать с идентификатором, используемым в CometAPI.
</Tip>

## Устранение неполадок

<AccordionGroup>
  <Accordion title="Не работает API key">
    Убедитесь, что API key указан правильно и на балансе есть доступные средства.
  </Accordion>

  <Accordion title="Не работает model ID">
    Убедитесь, что model ID точно соответствует тому, что ожидает CometAPI.
  </Accordion>

  <Accordion title="Не работает базовый URL API">
    Убедитесь, что базовый URL API включает `/v1` для OpenAI-совместимого метода.
  </Accordion>

  <Accordion title="Дополнительная помощь">
    Посетите [страницу поддержки CometAPI](https://www.cometapi.com/support/).
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/dify#howto",
        "name": "Подключение Dify к CometAPI",
        "description": "Используйте это руководство, чтобы подключить Dify к CometAPI, указав базовый URL, API key и параметры model или provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-1",
            "position": 1,
            "name": "Получите ваш API key CometAPI",
            "text": "Создайте или откройте свою учетную запись CometAPI, затем скопируйте активный API key из панели управления."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-2",
            "position": 2,
            "name": "Установите плагин CometAPI в Dify",
            "text": "Выполните шаг Install the CometAPI plugin in Dify в руководстве Connect Dify to CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-3",
            "position": 3,
            "name": "Добавьте ваш API key",
            "text": "Выполните шаг Add your API key в руководстве Connect Dify to CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-4",
            "position": 4,
            "name": "Добавьте модели",
            "text": "Выполните шаг Add models в руководстве Connect Dify to CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-5",
            "position": 5,
            "name": "Проверьте подключение",
            "text": "Выберите актуальный model ID на странице Models в CometAPI, затем отправьте тестовый запрос из интеграции."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-6",
            "position": 6,
            "name": "Откройте настройки provider модели",
            "text": "Выполните шаг Open model provider settings в руководстве Connect Dify to CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-7",
            "position": 7,
            "name": "Настройте модель",
            "text": "Выполните шаг Configure the model в руководстве Connect Dify to CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Документация CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Интеграции",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Подключение Dify к CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/dify"
          }
        ]
      }
    ]
    }
    `}
</script>