# Dify

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

> https://nezhagate.com/docs/integrations/dify

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

## 准备

- 工作空间的所有者或管理员账号，只有他们能配置模型供应商。

- 在插件市场（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 手册](https://nezhagate.com/docs/api) 里的 ID 为准。

**Agent 从不调用工具**

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

**长回答或长对话被截断**

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