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

# Usar o Coze com o CometAPI

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

O Coze é um criador de agentes de IA e fluxos de trabalho. Você pode conectar o CometAPI ao Coze de duas formas: por meio do **plugin nativo do CometAPI** (mais simples) ou por meio de um **nó HTTP Request** genérico para máxima flexibilidade.

## Pré-requisitos

* Uma conta CometAPI com uma chave de API ativa — [obtenha a sua aqui](https://www.cometapi.com/console/token)
* Uma conta Coze — [cadastre-se aqui](https://www.coze.com)

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

    <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 da CometAPI mostrando o botão 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="Detalhes da chave de API da CometAPI com base URL" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Adicione a CometAPI a um workflow do Coze">
    <Tabs>
      <Tab title="Método 1: Plugin da CometAPI (Recomendado)">
        1. No Coze, clique em **Get Started** e crie um novo workflow.
        2. No editor de workflow, clique em **Add Node → Plugins** e procure por **CometAPI**.
        3. Adicione o nó do plugin CometAPI ao seu workflow.

        <Frame>
          <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_355124.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=31a8c613d735f88246baa86ae399fa11" alt="Editor de workflow do Coze mostrando a busca de plugin" width="1900" height="928" data-path="images/integrations/810968_355124.png" />
        </Frame>

        <Frame>
          <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_355125.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=75f2336cc40c9f21d757ced6ee227fd7" alt="Plugin da CometAPI aparecendo nos resultados da busca" width="1904" height="940" data-path="images/integrations/810968_355125.png" />
        </Frame>

        <Frame>
          <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_355126.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=1058980811bfc31c51715a76e048cc02" alt="Nó do plugin CometAPI adicionado à área de trabalho" width="1938" height="908" data-path="images/integrations/810968_355126.png" />
        </Frame>

        <Frame>
          <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_360283.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=f89b117699a4d46802c62436ae92bd84" alt="Painel de configuração do nó do plugin" width="1869" height="963" data-path="images/integrations/810968_360283.png" />
        </Frame>

        4. No campo **API Key** do nó do plugin, cole sua chave de API da CometAPI.
        5. Clique em **Test** para verificar a conexão e depois em **Publish**.

        <Frame>
          <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_361332.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=0f41c0cfaf3cdcebd45d740ce96fd178" alt="Nó do plugin com a chave de API preenchida" width="1886" height="919" data-path="images/integrations/810968_361332.png" />
        </Frame>

        <Frame>
          <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_361333.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=17b349b2c651c6e5193bfde6b63e0c17" alt="Resultado de teste bem-sucedido para o plugin da CometAPI" width="1884" height="903" data-path="images/integrations/810968_361333.png" />
        </Frame>
      </Tab>

      <Tab title="Método 2: Nó HTTP Request">
        1. Crie um agente no Coze e, em seguida, no workflow do agente, adicione um nó **HTTP Request** entre os nós Start e End.
        2. Defina o seguinte:
           * **Method**: `POST`
           * **URL**: `https://api.cometapi.com/v1/chat/completions`
           * **Authentication Token**: cole sua chave de API da CometAPI e clique em **Confirm**
        3. Defina o corpo da requisição:

        ```json theme={null}
        {
          "model": "your-model-id",
          "messages": [
            {
              "role": "user",
              "content": "{{block_output_100001.input}}"
            }
          ],
          "stream": false
        }
        ```

        4. No nó End, defina a saída como o corpo da resposta da requisição HTTP. Substitua `your-model-id` por um model ID atual da [página de Models da CometAPI](/pt/overview/models).

        <Frame>
          <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_355128.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=862c588b2f301bd66b89366c5344fbdc" alt="Nó HTTP Request com URL e token de autenticação configurados" width="1586" height="834" data-path="images/integrations/810968_355128.png" />
        </Frame>

        <Frame>
          <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_355129.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=a438417210684dddf988307c448edb57" alt="JSON do corpo da requisição configurado no nó HTTP" width="1901" height="934" data-path="images/integrations/810968_355129.png" />
        </Frame>

        <Frame>
          <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_355130.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=18254fe80669e295bd7b8ac2e48c3d45" alt="Nó End com o corpo da resposta HTTP selecionado como saída" width="1926" height="936" data-path="images/integrations/810968_355130.png" />
        </Frame>

        <Frame>
          <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_355131.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=5fde76e14e42d41311076f7eb1d0fd77" alt="Workflow do Coze com todos os nós conectados" width="1901" height="909" data-path="images/integrations/810968_355131.png" />
        </Frame>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Teste e publique">
    Execute uma mensagem de teste no workflow (por exemplo, peça a hora atual). Uma resposta de IA bem-sucedida confirma que a integração está funcionando. Publique o workflow para colocá-lo em produção.

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_360285.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=5f362ef3274c53c47a8f3793d4fa6966" alt="Workflow do Coze mostrando uma resposta de teste bem-sucedida" width="1945" height="966" data-path="images/integrations/810968_360285.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_355132.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=8b7fe683331ec5cb31222062c6f3aa80" alt="Agente Coze publicado respondendo corretamente" width="1903" height="923" data-path="images/integrations/810968_355132.png" />
    </Frame>

    Se a chamada falhar, verifique sua chave de API e a URL do endpoint, ou entre em contato com o [suporte da CometAPI](https://www.cometapi.com).
  </Step>
</Steps>

<Tip>
  O método de plugin é recomendado para a maioria dos usuários — ele lida automaticamente com a autenticação e o parsing da resposta. Use o nó HTTP Request quando precisar de controle total sobre os headers da requisição ou quiser chamar um endpoint que não seja de chat.
</Tip>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/coze#howto",
        "name": "Usar Coze com CometAPI",
        "description": "Use este guia para configurar o Coze com a CometAPI definindo a base URL, a chave de API e as opções de model ou provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/coze#step-1",
            "position": 1,
            "name": "Obtenha sua chave de API da CometAPI",
            "text": "Crie ou abra sua conta CometAPI e depois copie uma chave de API ativa do painel."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/coze#step-2",
            "position": 2,
            "name": "Adicione a CometAPI a um workflow do Coze",
            "text": "Conclua a etapa Adicione a CometAPI a um workflow do Coze no guia Usar Coze com CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/coze#step-3",
            "position": 3,
            "name": "Teste e publique",
            "text": "Conclua a etapa Teste e publique no guia Usar Coze com 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": "Usar Coze com CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/coze"
          }
        ]
      }
    ]
    }
    `}
</script>
