算力猫
← 返回教程列表

接入软件

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 官方文档只写了通用流程(装插件 → 点供应商卡片上的「添加模型」);下面的字段名来自官方插件自带的中文文案,不同插件版本的措辞可能略有差别,以界面为准。

去创建 Key →

步骤 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)。