接入软件
Dify
在 Dify 里用「OpenAI-API-compatible」模型供应商接入。
约 8 分钟适合:在 Dify 里搭建应用和工作流的用户
开始之前
- Dify 的工作空间管理员或所有者权限
- 一把 Key 和一个模型名
步骤 1 · STEP 0x01
安装 OpenAI-API-compatible 供应商
集成 → 模型供应商
1
安装
OpenAI-API-compatible
langgenius 出的官方插件,在 Marketplace 里
- 进入「集成 → 模型供应商」,从 Marketplace 安装 OpenAI-API-compatible 插件。
- 只有工作空间的所有者和管理员能管理模型供应商。
Dify 官方文档只写了通用流程(装插件 → 点供应商卡片上的「添加模型」);下面的字段名来自官方插件自带的中文文案,不同插件版本的措辞可能略有差别,以界面为准。
步骤 2 · STEP 0x02
添加模型
OpenAI-API-compatible → 添加模型
1
模型类型
LLM
2
模型名称
<模型名>
3
API Key
<你的 Key>
4
API Base URL
https://api.suanlimao.shop/v1
5
API 类型
Chat Completions API (/chat/completions)
6
函数调用类型
工具调用(模型支持时)
7
保存
- API Base URL 填
https://api.suanlimao.shop/v1(插件的提示文字就是这种带 /v1 的写法);路径 /chat/completions 由插件按「API 类型」自动拼接,不要自己写。 - 模型名称必须是我们接口里真实存在的名字;「API endpoint 中的模型名称」留空即与模型名称相同。
- 「对话类型」保持「对话」;上下文长度、最大 token 上限按模型广场里该模型的参数填。
- 保存时 Dify 会发一次请求验证凭据;失败先检查地址、Key、模型名。
官方插件说明:只有 LLM 类型的模型用带 /v1 的地址;向量(embedding)、重排序等类型插件会自己补版本号,要填不带 /v1 的根地址
https://api.suanlimao.shop,否则会变成 /v1/v1。模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。
步骤 3 · STEP 0x03
在应用里使用
应用编排
1
模型
选刚添加的模型
2
提示词
你是一个乐于助人的助手
- 在应用或工作流的 LLM 节点里选择这个模型。
- 需要多个模型,就重复「添加模型」,每个模型名添加一次;Dify 对同名同类型的模型只会追加密钥,不会重复创建。
工作流会反复调用模型,用量比聊天大得多。建议给这把 Key 设预算上限。
✓ 怎么确认成功了
- 应用的「预览与调试」里能得到回答,控制台「用量」页出现请求。
常见问题
保存模型时提示验证失败?
按顺序检查:地址是否带 /v1 且没有多写 /chat/completions;Key 是否完整;模型名是否与模型广场一致;余额是否充足。
模型能回答,但工具调用 / 函数调用不生效?
在模型设置里把「函数调用类型」改为「工具调用」,并确认模型广场里该模型支持工具调用。
想用多个模型?
每个模型名单独添加一次,Key 和地址可以相同。
相关教程
还是不行?
先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。