> ## 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.

# Conectar o Dify ao CometAPI

> Use este guia para conectar o Dify ao CometAPI definindo a URL base, a chave de API e as opções de model ou provider.

[Dify](https://dify.ai) é uma plataforma open-source para desenvolvimento de aplicações LLM. Ao conectá-la ao CometAPI, você pode usar os model IDs atuais do CometAPI dentro dos construtores de workflow, chatbot e agent do Dify.

## Pré-requisitos

* Uma conta CometAPI com uma chave de API ativa — [faça login para obter uma](https://www.cometapi.com)
* Uma conta Dify — [cloud](https://cloud.dify.ai/signin) ou self-hosted

## Método 1: plugin do CometAPI (recomendado)

A forma mais fácil de conectar. O Marketplace do Dify fornece um plugin oficial do CometAPI que gerencia a integração automaticamente.

<Steps>
  <Step title="Obtenha sua chave de API do CometAPI">
    Faça login no [painel do CometAPI](https://www.cometapi.com/console). Clique em **Add API Key** e copie sua chave.

    <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="Painel do CometAPI mostrando o botão Add API Key e a lista de chaves" 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="Detalhes da chave de API do CometAPI mostrando a URL base https://api.cometapi.com" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Instale o plugin do CometAPI no Dify">
    No Dify, vá para **Plugins** → **Install Plugin** → **Marketplace**. Procure por `cometapi` e instale.

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_360267.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=85e4b1a60c912aa98c182ed731cde19f" alt="Resultados da pesquisa no marketplace de plugins do Dify mostrando o plugin do 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="Caixa de diálogo de confirmação da instalação do plugin do CometAPI no Dify" width="1865" height="896" data-path="images/integrations/810968_360269.png" />
    </Frame>
  </Step>

  <Step title="Adicione sua chave de API">
    Vá para **Settings** → **Model Provider** → **CometAPI** → **Open Settings**. Cole sua chave de API do CometAPI e clique em **Save**.
  </Step>

  <Step title="Adicione modelos">
    Insira um model ID da [página de Models do CometAPI](/pt/overview/models) e clique em **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="Configurações do provider de modelos no Dify mostrando o formulário de configuração do 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="Lista de modelos no Dify com modelos do CometAPI adicionados com sucesso" width="1935" height="870" data-path="images/integrations/810968_362637.png" />
    </Frame>
  </Step>

  <Step title="Teste a conexão">
    Crie um chatbot ou workflow e selecione um modelo do CometAPI. Envie uma mensagem de teste — uma resposta bem-sucedida confirma que a integração está funcionando.

    <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="Interface de chat do Dify mostrando uma resposta bem-sucedida de um modelo do CometAPI" width="1910" height="924" data-path="images/integrations/810968_362638.png" />
    </Frame>
  </Step>
</Steps>

## Método 2: provider compatível com OpenAI

Use este método para adicionar modelos não cobertos pelo plugin do CometAPI, como Claude, Grok ou Gemini — ou para usar nomes de modelos personalizados.

<Steps>
  <Step title="Abra as configurações do provider de modelos">
    Vá para **Settings** → **Model Provider** → **OpenAI-API-compatible** → **Add Model**.
  </Step>

  <Step title="Configure o modelo">
    Preencha os seguintes campos:

    | Field           | Value                                               |
    | --------------- | --------------------------------------------------- |
    | Tipo de modelo  | LLM                                                 |
    | Nome do modelo  | Model ID do CometAPI (deve corresponder exatamente) |
    | Chave de API    | Sua chave de API do CometAPI                        |
    | URL base da API | `https://api.cometapi.com/v1`                       |

    Clique em **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="Formulário de provider compatível com OpenAI no Dify com os valores do CometAPI preenchidos" 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="Lista de modelos no Dify mostrando uma entrada de modelo compatível com CometAPI recém-salva" width="1953" height="965" data-path="images/integrations/810968_354448.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Para identificadores de modelo, consulte a [página de Models do CometAPI](/pt/overview/models). O model ID no Dify deve corresponder exatamente ao identificador usado no CometAPI.
</Tip>

## Solução de problemas

<AccordionGroup>
  <Accordion title="A chave da API falha">
    Confirme que a chave da API está correta e tem saldo disponível.
  </Accordion>

  <Accordion title="O model ID falha">
    Confirme que o model ID corresponde exatamente ao que a CometAPI espera.
  </Accordion>

  <Accordion title="A URL base da API falha">
    Confirme que a URL base da API inclui `/v1` para o método compatível com OpenAI.
  </Accordion>

  <Accordion title="Mais ajuda">
    Visite a [página de suporte da 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": "Conectar o Dify à CometAPI",
        "description": "Use este guia para conectar o Dify à CometAPI definindo a URL base, a chave da API e as opções de model ou provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-1",
            "position": 1,
            "name": "Obtenha sua chave da API da CometAPI",
            "text": "Crie ou abra sua conta da CometAPI e, em seguida, copie uma chave da API ativa do painel."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-2",
            "position": 2,
            "name": "Instale o plugin da CometAPI no Dify",
            "text": "Conclua a etapa Instale o plugin da CometAPI no Dify no guia Conectar o Dify à CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-3",
            "position": 3,
            "name": "Adicione sua chave da API",
            "text": "Conclua a etapa Adicione sua chave da API no guia Conectar o Dify à CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-4",
            "position": 4,
            "name": "Adicione modelos",
            "text": "Conclua a etapa Adicione modelos no guia Conectar o Dify à CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-5",
            "position": 5,
            "name": "Teste a conexão",
            "text": "Selecione um model ID atual na página Models da CometAPI e, em seguida, envie uma solicitação de teste a partir da integração."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-6",
            "position": 6,
            "name": "Abra as configurações do provider do modelo",
            "text": "Conclua a etapa Abra as configurações do provider do modelo no guia Conectar o Dify à CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-7",
            "position": 7,
            "name": "Configure o modelo",
            "text": "Conclua a etapa Configure o modelo no guia Conectar o Dify à CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentação da CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrações",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Conectar o Dify à CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/dify"
          }
        ]
      }
    ]
    }
    `}
</script>