Dify 配置

## 1 关于 Dify

[Dify](https://dify.ai/zh)提供从 Agent 构建到 AI workflow 编排、RAG 检索、模型管理等能力，轻松构建和运营生成式 AI 原生应用，比 LangChain 更易用。

Dify有两种使用方法，第一种是在线使用，登录 [Dify官网](https://dify.ai/zh)，点击 开始使用即可使用；第二种是本地部署的方式，具体可以参考 [Dify文档](https://docs.dify.ai/) 。下面文档按照第一种在线使用方式进行介绍。

## 2 在 Dify 中使用 CloudCare API

### 2.1 配置 CloudCare API Key

点击左上角 “功能菜单”，找到 “AI Hub”-“[API 密钥](https://enterprise.cloudcare.cn/ai-hub/api-keys)” 后，点击进入 “ [API 密钥](https://enterprise.cloudcare.cn/ai-hub/api-keys)” 功能页面。

![](<https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-07-21_170156_2148830.9933488176154266.png "null"> "null")

## 操作前提

1、账号必须存在于该空间下  
2、账号必须是该空间（读写）及以上权限  
3、账号在 AI Hub 模块没有被禁用

需满足以上三种条件，才可对 API 密钥进行添加、编辑、删除等操作。

## 添加

点击右上角 “创建密钥”，并在 “创建 API 密钥” 弹窗中填写以下字段信息：

- Key 名称（API Key 的名称）
- IP 白名单（设置该 API key 可访问的 IP 地址）
- 可访问模型（设置该 API Key 可使用的模型）
- 过期时间（不设置时间则永不过期）

![](<https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-08-17_143915_0914800.3836587440798166.png "null"> "null")

点击 “确认” 后，即可完成 API 密钥的创建。

## 复制

> 仅该 API 密钥的创建者可以使用该 API 密钥的复制操作

点击操作栏中的 “复制” 按钮，会展示 “API 调用信息” 的弹窗：

- 协议类型
- 请求地址（支持 “复制” 操作）
- API Key（支持 “复制” 操作）

![](<https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-08-17_144256_0470590.30777762648672846.png "null"> "null")

## 使用说明

1、请确保使用的工具支持自定义请求地址，否则无法进行配置  
2、请确保账户余额充足，否则无法调用服务  
3、请确保 API Key 未被禁用或过期，否则无法调用服务  
4、请确保调用量未超过当月 Token 限额或费用限制，否则无法调用服务

### 2.2 在 Dify 中配置

#### 2.2.1 打开 Dify应用

打开 [Dify应用]，登录之后，点击右上角个人信息下拉选项，选择设置，进入到设置页面
![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-09-02_164538_9566940.6345841263771738.png)

在设置页面中选择 模型供应商 OpenAI-API-compatible 插件并安装（如已安装则跳过）
![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-09-02_165729_9741070.39407726330495807.png)

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-09-02_163857_7376750.16136284340036855.png)
#### 2.2.2 配置 CloudCare 的接入信息

1. 在设置页面中选择 模型供应商 
2. 向下滚动，找到 OpenAI-API-compatible，然后点击开始添加模型，我们开始添加第一个模型，按照如下填写完成，其中API Key是CloudCare中的APIKey，点击保存，稍等片刻，提示添加成功  
![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-09-02_163910_7522630.01716620134876834.png)
> 注意：部分模型（例如gemini），启用思考模式 需要启用以下两项配置
> - 思考模式支持：仅支持思考模式/两种模式都支持
> - 兼容模式：扩展（启用额外设置）
![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-09-14_120417_4051340.546155728997617.png)

3. 添加更多模型，鼠标移动到 OpenAI-API-compatible区域，会显示”添加模型“按钮，点击开始添加，例如添加 deepseek-v3 和 ernie-4.0-turbo-8k 两个模型，添加时，API Key仍使用同一个即可

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-09-02_163941_1865970.10970660681935185.png)

4. 添加完成之后，鼠标移动到 OpenAI-API-compatible区域，可以看到该区域左下角"显示3个模型"，点击展开，即可看到添加的三个模型

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-09-02_163948_6449360.46599379564541976.png)
#### 2.2.3 配置 聊天助手

1. 选择Dify菜单中的"工作室"，点击创"建空白应用" 
![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-09-02_163813_4324340.9233273463790987.png) 
2. 点击右上角，切换模型，可以看到刚刚添加的三个模型，如果不显示，请刷新浏览器页面
![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-09-02_163807_6771180.47702314041680394.png)
  #### 2.2.4 开始聊天
  
3. 按照上面步骤，Dify 已经配置完成，可在输入框中进行对话测试。
![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-09-02_163745_1532670.26612578827982103.png)
4. 同理，可以选择刚刚添加的 deepseek-v3 和 ernie-4.0-turbo-8k 模型，进行对话，测试完成之后，可以发布。
  
  ## 3 结语
  
  Dify 为开发者提供了健全的应用模版和编排框架，你可以基于它们快速构建大型语言模型驱动的生成式AI 应用，将创意变为现实，也可以随时按需无缝扩展，驱动业务增长。CloudCare完美的与Dify进行了适配，开发者可以很简单的使用，提高开发效率。