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

> 使用本指南，通过设置 base URL、API key 以及 model 或 provider 选项，将 Dify 连接到 CometAPI。

[Dify](https://dify.ai) 是一个开源的 LLM 应用开发平台。将其连接到 CometAPI 后，你可以在 Dify 的工作流、聊天机器人和智能体构建器中使用当前的 CometAPI model ID。

## 前提条件

* 一个拥有有效 API key 的 CometAPI 账户 — [登录以获取](https://www.cometapi.com)
* 一个 Dify 账户 — [云端版](https://cloud.dify.ai/signin) 或自托管版

## 方法 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="显示 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 https://api.cometapi.com 的 CometAPI API key 详情" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="在 Dify 中安装 CometAPI 插件">
    在 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="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="Dify 中的 CometAPI 插件安装确认对话框" 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="添加模型">
    输入来自 [CometAPI Models 页面](/zh-Hans/overview/models) 的 model ID，然后点击 **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="显示 CometAPI 配置表单的 Dify 模型提供商设置" 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="测试连接">
    创建一个聊天机器人或工作流，并选择一个 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 兼容 provider

使用此方法可添加 CometAPI 插件未覆盖的模型，例如 Claude、Grok 或 Gemini，或者使用自定义模型名称。

<Steps>
  <Step title="打开模型提供商设置">
    前往 **Settings** → **Model Provider** → **OpenAI-API-compatible** → **Add Model**。
  </Step>

  <Step title="配置模型">
    填写以下字段：

    | Field        | Value                          |
    | ------------ | ------------------------------ |
    | 模型类型         | LLM                            |
    | 模型名称         | 来自 CometAPI 的 model ID（必须完全一致） |
    | 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="已填入 CometAPI 值的 Dify OpenAI 兼容 provider 表单" 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 兼容模型条目" width="1953" height="965" data-path="images/integrations/810968_354448.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  关于模型标识符，请参阅 [CometAPI Models 页面](/zh-Hans/overview/models)。Dify 中的 model ID 必须与 CometAPI 中使用的标识符完全一致。
</Tip>

## 故障排查

<AccordionGroup>
  <Accordion title="API key 无效">
    确认 API key 正确且账户有可用余额。
  </Accordion>

  <Accordion title="model ID 无效">
    确认 model ID 与 CometAPI 要求的值完全一致。
  </Accordion>

  <Accordion title="API base URL 无效">
    确认 API base URL 对于 OpenAI 兼容方式包含 `/v1`。
  </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": "使用本指南，通过设置 base URL、API key 以及 model 或 provider 选项，将 Dify 连接到 CometAPI。",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-1",
            "position": 1,
            "name": "获取你的 CometAPI API key",
            "text": "创建或打开你的 CometAPI 账户，然后从控制台复制一个有效的 API key。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-2",
            "position": 2,
            "name": "在 Dify 中安装 CometAPI 插件",
            "text": "完成“将 Dify 连接到 CometAPI”指南中的“在 Dify 中安装 CometAPI 插件”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-3",
            "position": 3,
            "name": "添加你的 API key",
            "text": "完成“将 Dify 连接到 CometAPI”指南中的“添加你的 API key”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-4",
            "position": 4,
            "name": "添加模型",
            "text": "完成“将 Dify 连接到 CometAPI”指南中的“添加模型”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-5",
            "position": 5,
            "name": "测试连接",
            "text": "从 CometAPI Models 页面选择一个当前可用的 model ID，然后从集成中发送测试请求。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-6",
            "position": 6,
            "name": "打开模型提供商设置",
            "text": "完成“将 Dify 连接到 CometAPI”指南中的“打开模型提供商设置”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-7",
            "position": 7,
            "name": "配置模型",
            "text": "完成“将 Dify 连接到 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>
