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

# 使用 Coze 与 CometAPI

> 使用本指南通过设置 base URL、API key 以及 model 或 provider 选项，在 Coze 中配置 CometAPI。

Coze 是一个 AI 智能体和工作流构建平台。你可以通过两种方式将 CometAPI 连接到 Coze：使用原生的 **CometAPI 插件**（最简单），或使用通用的 **HTTP Request 节点** 以获得最大的灵活性。

## 前提条件

* 一个带有有效 API key 的 CometAPI 账户——[在此获取](https://www.cometapi.com/console/token)
* 一个 Coze 账户——[在此注册](https://www.coze.com)

<Steps>
  <Step title="获取你的 CometAPI API key">
    登录 [CometAPI 控制台](https://www.cometapi.com/console/token)。点击 **Add API Key** 并复制你的 CometAPI 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="显示 Add API Key 按钮的 CometAPI 控制台" 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="包含 base URL 的 CometAPI API key 详情" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="将 CometAPI 添加到 Coze 工作流">
    <Tabs>
      <Tab title="方法 1：CometAPI 插件（推荐）">
        1. 在 Coze 中，点击 **Get Started** 并创建一个新的工作流。
        2. 在工作流编辑器中，点击 **Add Node → Plugins** 并搜索 **CometAPI**。
        3. 将 CometAPI 插件节点添加到你的工作流中。

        <Frame>
          <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_355124.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=31a8c613d735f88246baa86ae399fa11" alt="显示插件搜索的 Coze 工作流编辑器" 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="搜索结果中出现的 CometAPI 插件" 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="已添加到画布的 CometAPI 插件节点" 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="插件节点配置面板" width="1869" height="963" data-path="images/integrations/810968_360283.png" />
        </Frame>

        4. 在插件节点的 **API Key** 字段中，粘贴你的 CometAPI API key。
        5. 点击 **Test** 验证连接，然后点击 **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="已填写 API key 的插件节点" 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="CometAPI 插件的测试成功结果" width="1884" height="903" data-path="images/integrations/810968_361333.png" />
        </Frame>
      </Tab>

      <Tab title="方法 2：HTTP Request 节点">
        1. 在 Coze 中创建一个 agent，然后在该 agent 的工作流里，在 Start 和 End 节点之间添加一个 **HTTP Request** 节点。
        2. 设置以下内容：
           * **Method**: `POST`
           * **URL**: `https://api.cometapi.com/v1/chat/completions`
           * **Authentication Token**：粘贴你的 CometAPI API key，然后点击 **Confirm**
        3. 设置请求体：

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

        4. 在 End 节点中，将输出设置为 HTTP 请求的响应体。将 `your-model-id` 替换为来自 [CometAPI Models 页面](/zh-Hans/overview/models) 的当前 model ID。

        <Frame>
          <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_355128.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=862c588b2f301bd66b89366c5344fbdc" alt="已配置 URL 和 auth token 的 HTTP Request 节点" 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="在 HTTP 节点中配置的请求体 JSON" 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="在 End 节点中选择 HTTP 响应体作为输出" 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="所有节点均已连接的 Coze 工作流" width="1901" height="909" data-path="images/integrations/810968_355131.png" />
        </Frame>
      </Tab>
    </Tabs>
  </Step>

  <Step title="测试并发布">
    在工作流中运行一条测试消息（例如询问当前时间）。如果 AI 成功回复，则表示集成工作正常。发布该工作流以使其上线。

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_360285.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=5f362ef3274c53c47a8f3793d4fa6966" alt="显示测试响应成功的 Coze 工作流" 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="已发布并正确响应的 Coze agent" width="1903" height="923" data-path="images/integrations/810968_355132.png" />
    </Frame>

    如果调用失败，请检查你的 API key 和端点 URL，或联系 [CometAPI 支持](https://www.cometapi.com)。
  </Step>
</Steps>

<Tip>
  对大多数用户来说，推荐使用插件方式——它会自动处理身份验证和响应解析。当你需要完全控制请求头，或想调用非聊天端点时，请使用 HTTP Request 节点。
</Tip>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/coze#howto",
        "name": "将 Coze 与 CometAPI 搭配使用",
        "description": "使用本指南，通过设置 base URL、API key 以及 model 或 provider 选项来配置 Coze 与 CometAPI。",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/coze#step-1",
            "position": 1,
            "name": "获取你的 CometAPI API key",
            "text": "创建或打开你的 CometAPI 账户，然后从控制台复制一个有效的 API key。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/coze#step-2",
            "position": 2,
            "name": "将 CometAPI 添加到 Coze 工作流",
            "text": "完成“将 CometAPI 添加到 Coze 工作流”这一步骤，详见“将 Coze 与 CometAPI 搭配使用”指南。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/coze#step-3",
            "position": 3,
            "name": "测试并发布",
            "text": "完成“将 Coze 与 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": "将 Coze 与 CometAPI 搭配使用",
            "item": "https://apidoc.cometapi.com/integrations/coze"
          }
        ]
      }
    ]
    }
    `}
</script>
