准备工作
- 一个可用的 Dify:官方云服务或自己部署的版本都可以。
- 零点数据 API Key:在控制台「令牌」页面新建,以
sk-开头。 - 模型名称和参数:在控制台模型列表里复制模型名称,并记下它的上下文长度。
1安装模型供应商插件
- 登录 Dify,点击右上角头像,进入设置 → 模型供应商。
- 在供应商列表或插件市场里搜索 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在应用里使用
- 新建或打开一个应用,在模型选择处找到刚添加的模型。
- 在右侧的调试与预览里发一句话,能正常回复就说明接通了。
- 如果希望新建应用时默认就用它,可以在模型供应商 → 系统模型设置里把它设为默认推理模型。
自部署 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 即可。