Source: https://wiki.niceai.dev/guide/clients/dify

# Dify 接入自定义 API

在 Dify 的「模型供应商」中安装 **OpenAI-API-compatible** 插件，添加模型时 API Base URL 填 `https://api.niceai.dev/v1`，填入 NiceAI 密钥和模型名，即可在应用和工作流中使用。

## 准备工作

1. 一个可用的 Dify（云端或自部署）。
2. 在 NiceAI 控制台「[API 密钥](https://niceai.dev/keys)」页面创建密钥，分组按所用模型选择。建议给 Dify 单独建一个密钥，方便查看用量。

## 配置步骤

1. 进入 **集成 → 模型供应商**（不同版本也可能在「设置 → 模型供应商」）。
2. 在 Marketplace 中找到 langgenius 发布的 **OpenAI-API-compatible** 插件并安装。
3. 在插件卡片上点击 **添加模型**，按下表填写：

| 字段 | 填写内容 |
| --- | --- |
| 模型类型 | LLM |
| 模型名称 | [模型广场](https://niceai.dev/model-plaza) 中的模型名，会原样作为 `model` 发送 |
| API Key | 你的 NiceAI 密钥 |
| API Base URL（旧版叫 API endpoint URL） | `https://api.niceai.dev/v1` |
| 对话类型 | 对话（Chat） |
| 模型上下文长度 | 按模型实际上下文填写 |

4. 保存时 Dify 会发一个小请求验证凭据，通过后即可在应用中选用该模型。需要多个模型就逐个添加。

**注意插件名称**
Dify 官方插件仓库里还有一个把 Dify 应用转成 OpenAI 接口的扩展，名字相近但方向相反。接入 NiceAI 要装的是 **模型供应商** 类的 OpenAI-API-compatible。


## 常见问题

### 保存时提示 404？

API Base URL 要正好是 `https://api.niceai.dev/v1`，插件会自动拼接 `/chat/completions`。详见 [接口地址要不要加 /v1](https://wiki.niceai.dev/guide/v1-404)。

### 工具调用或流式输出异常？

在模型设置中按模型能力调整 Function Call 和流式相关选项；不支持工具调用的模型不要开启。

## 下一步

- [n8n 接入](https://wiki.niceai.dev/guide/clients/n8n)
- [常见错误码对照](https://wiki.niceai.dev/guide/error-codes)
