---
url: https://limapi.com/docs/agents/dify.md
---
# Dify

Dify 是一个开源的大模型应用开发平台，可基于 LimAPI 提供的模型 API 构建聊天助手、Agent、Chatflow / 工作流与知识库应用。

## 前提条件

* 在 [Portal](https://limapi.com/) 创建 API Key（`sk-` 开头）；
* 拥有 Dify 云服务账号或已私有化部署 Dify。

## 1. 配置模型

### 1.1 安装模型供应商

前往 **Dify 市场**，在「模型」分类下找到 **OpenAI-API-compatible** 插件并安装。

::: info 为什么用 OpenAI-API-compatible
LimAPI 完整兼容 OpenAI 协议，使用该插件可接入平台全部文本模型，且不受特定厂商插件版本限制。
:::

### 1.2 配置 API Key

单击页面右上角头像 → **设置**，在「模型供应商」处找到 OpenAI-API-compatible 卡片，点击 **设置**，填入：

| 配置项 | 填写内容 |
|--------|----------|
| API-Key | Portal 创建的 API Key（`sk-` 开头） |
| API endpoint URL | `https://limapi.com/api/v1` |

### 1.3 选择模型

在卡片中点击 **显示模型**，打开您需要使用的模型开关；或直接添加模型 ID（如 `qwen3.8-max`、`claude-sonnet-4-6`）。

::: tip 查询可用模型
完整模型列表与定价见 [模型列表](/guide/models)，或调用 `GET /api/v1/models` 获取。
:::

## 2. 开始使用

### 聊天助手 / Agent

1. 在 **工作室** 单击创建空白应用，创建一个聊天助手或 Agent 并进入；
2. 在应用页面右上角选择 LimAPI 供应商下的模型；
3. 输入「你是谁」测试对话。使用视觉模型（如 `qwen3.8-max`）时，打开「视觉」开关即可在对话框输入图片。

### Chatflow / 工作流

1. 创建一个 Chatflow 或工作流并进入；
2. 在画布中添加 **LLM 节点**，选中节点进入编辑界面，选择 LimAPI 模型；
3. 单击 **添加消息**，在 USER 消息下输入问题，点击节点右上角的 **运行** 按钮验证输出。

### 知识库

创建知识库时，Embedding 模型可选择 LimAPI 的向量化模型（端点 `POST /api/v1/embeddings`，详见 [Embeddings 文本向量化](/guide/embeddings)；Rerank 端点为 `POST /api/v1/rerank`，详见 [Rerank 重排序](/guide/rerank)）。

### 图像 / 视频生成（HTTP 节点）

Dify 暂无 LimAPI 图像 / 视频专用插件，可通过 Chatflow / 工作流的 **HTTP 节点** 接入：

* 文生图：`POST https://limapi.com/api/v1/images/generations`，见 [图片生成](/guide/images)；
* 视频生成：`POST https://limapi.com/api/v1/videos` 创建任务 + `GET /api/v1/videos/{taskId}` 轮询，见 [视频生成](/guide/videos)。

::: warning 超时建议
视频生成耗时数分钟，为降低 HTTP 节点超时风险，建议节点只负责「创建任务」，轮询逻辑放在后续节点或通过流式输出方式调用。
:::

## 常见问题

### 配置 API Key 报错 Invalid API-key provided

* 确认 API-Key 为 Portal 创建的 `sk-` 开头密钥，复制完整；
* 确认 endpoint URL 为 `https://limapi.com/api/v1`；
* 若最新版插件报错，可尝试安装较早版本的 OpenAI-API-compatible 插件。

### 如何使用思考模型？

在 LLM 节点 / 应用模型设置中开启「思考模式」相关开关（插件版本不同文案略有差异），否则仅强制思考类模型会报错。

### 如何使用语音、实时语音等模型？

TTS / ASR / Realtime TTS 等接口不经过 OpenAI 兼容插件，请通过 HTTP 节点直接调用，接口定义见 [语音合成 TTS](/guide/tts)、[语音识别 ASR](/guide/asr)、[实时语音合成](/guide/realtime-tts)。