NezhaGateNezhaGate

Dify 通过「OpenAI-API-compatible」模型供应商接入任何 OpenAI 兼容服务。每个模型单独添加,有几处默认值需要改。

按此版本编写:Dify 1.17 · OpenAI-API-compatible 0.0.68

准备

  • 工作空间的所有者或管理员账号,只有他们能配置模型供应商。
  • 在插件市场(Marketplace)安装 OpenAI-API-compatible(langgenius 官方插件)。

添加模型

打开 Model Provider(新版在「集成」里,旧版在「设置」里),在 OpenAI-API-compatible 卡片上点 Add Model,按下表填写:

字段填什么
Model TypeLLM
Model Name完整的模型 ID,例如 gpt-5.5
API Key你的 NezhaGate API Key
API Base URLhttps://nezhagate.com/v1
Completion modeChat
Model context size模型的真实上下文长度(见模型的 API 文档)。默认是 4096,不改的话长对话会被截断。
Upper bound for max tokens模型单次最多输出的 token 数,默认也是 4096。
Function Call Type支持工具调用的模型选 Tool Call。默认是 Not Support,Agent 就不会调用工具。
Vision Support支持图片输入的模型选 Support。
API Type保持 Chat Completions API。

地址必须带 /v1,插件会在后面直接拼上 /chat/completions。其余字段保持默认即可。

Claude(可选)

也可以安装官方的 Anthropic 插件,把 API URL 填成 https://nezhagate.com/anthropic,再用 Add Model 逐个添加 Claude 模型(例如 claude-sonnet-5)。

测试

保存时 Dify 会发一条很短的请求做验证(按实际用量计一笔很小的费用)。之后在 Studio 新建一个聊天助手,选这个模型,在预览里发一条消息。

常见问题

Credentials validation failed with status code 404

地址少了 /v1,应为 https://nezhagate.com/v1。

验证返回 401 或 model not found

401 是 Key 不对;model not found 是模型 ID 拼错了,以 API 手册 里的 ID 为准。

Agent 从不调用工具

模型表单里的 Function Call Type 还是 Not Support,改成 Tool Call。

长回答或长对话被截断

Model context size 和 Upper bound for max tokens 还是默认的 4096,按模型的实际值调大。

更多集成