Appearance
Dify
Dify 是一个开源的大模型应用开发平台，可基于 LimAPI 提供的模型 API 构建聊天助手、Agent、Chatflow / 工作流与知识库应用。
前提条件
- 在 Portal 创建 API Key（
sk-开头）； - 拥有 Dify 云服务账号或已私有化部署 Dify。
1. 配置模型
1.1 安装模型供应商
前往 Dify 市场，在「模型」分类下找到 OpenAI-API-compatible 插件并安装。
为什么用 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）。
查询可用模型
完整模型列表与定价见 模型列表，或调用 GET /api/v1/models 获取。
2. 开始使用
聊天助手 / Agent
- 在 工作室 单击创建空白应用，创建一个聊天助手或 Agent 并进入；
- 在应用页面右上角选择 LimAPI 供应商下的模型；
- 输入「你是谁」测试对话。使用视觉模型（如
qwen3.8-max）时，打开「视觉」开关即可在对话框输入图片。
Chatflow / 工作流
- 创建一个 Chatflow 或工作流并进入；
- 在画布中添加 LLM 节点，选中节点进入编辑界面，选择 LimAPI 模型；
- 单击 添加消息，在 USER 消息下输入问题，点击节点右上角的 运行 按钮验证输出。
知识库
创建知识库时，Embedding 模型可选择 LimAPI 的向量化模型（端点 POST /api/v1/embeddings，详见 Embeddings 文本向量化；Rerank 端点为 POST /api/v1/rerank，详见 Rerank 重排序）。
图像 / 视频生成（HTTP 节点）
Dify 暂无 LimAPI 图像 / 视频专用插件，可通过 Chatflow / 工作流的 HTTP 节点 接入：
- 文生图：
POST https://limapi.com/api/v1/images/generations，见 图片生成； - 视频生成：
POST https://limapi.com/api/v1/videos创建任务 +GET /api/v1/videos/{taskId}轮询，见 视频生成。
超时建议
视频生成耗时数分钟，为降低 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、语音识别 ASR、实时语音合成。