Dify
Dify 通过「OpenAI-API-compatible」模型供应商接入任何 OpenAI 兼容服务。每个模型单独添加,有几处默认值需要改。
准备
- 工作空间的所有者或管理员账号,只有他们能配置模型供应商。
- 在插件市场(Marketplace)安装 OpenAI-API-compatible(langgenius 官方插件)。
添加模型
打开 Model Provider(新版在「集成」里,旧版在「设置」里),在 OpenAI-API-compatible 卡片上点 Add Model,按下表填写:
| 字段 | 填什么 |
|---|---|
| Model Type | LLM |
| Model Name | 完整的模型 ID,例如 gpt-5.5 |
| API Key | 你的 NezhaGate API Key |
| API Base URL | https://nezhagate.com/v1 |
| Completion mode | Chat |
| 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,按模型的实际值调大。