准备工作

1安装模型供应商插件

  1. 登录 Dify,点击右上角头像,进入设置 → 模型供应商。
  2. 在供应商列表或插件市场里搜索 OpenAI-API-compatible,点击安装。

Dify 1.0 之后,模型供应商改成了插件形式,需要先安装才能使用。较早的版本里这个供应商是内置的,可以直接跳到下一步。

2添加模型

在 OpenAI-API-compatible 卡片上点击添加模型,按下表填写:

设置项 填写内容
模型类型 LLM(对话模型)
模型名称 控制台复制的模型名称,例如 deepseek-v3.2,必须完全一致
API Key 你的零点数据 API Key
API endpoint URL https://api.gxxai.cn/v1
模型上下文长度、最大 token 上限 按该模型的说明填写;不确定时先用默认值
Function calling(工具调用) 模型支持时选择支持;要做智能体(Agent)必须开启
Vision(看图) 只有支持图片输入的模型才开启

点击保存,Dify 会用这些信息试调一次,校验通过后模型就添加成功了。要用多个模型,重复这一步逐个添加。

3在应用里使用

  1. 新建或打开一个应用,在模型选择处找到刚添加的模型。
  2. 在右侧的调试与预览里发一句话,能正常回复就说明接通了。
  3. 如果希望新建应用时默认就用它,可以在模型供应商 → 系统模型设置里把它设为默认推理模型。

自部署 Dify 注意:服务器需要能访问 api.gxxai.cn。如果部署在内网,请确认防火墙或代理允许访问外网。

常见问题

保存时提示校验失败

依次检查:API endpoint URL 是否是 https://api.gxxai.cn/v1;Key 是否正确;模型名称是否和控制台完全一致。

智能体不调用工具

添加模型时需要把 Function calling 设为支持,并且所选模型本身要具备工具调用能力。

自部署的 Dify 连不上

在 Dify 所在服务器上用 curl https://api.gxxai.cn 测试能否访问。访问不了说明是服务器网络或代理设置问题。

知识库需要的 Embedding 模型怎么加?

如果控制台的模型列表里提供了 Embedding(向量)模型,用同样的方法添加,模型类型选 Text Embedding 即可。