外观
Dify 接入自定义 API
在 Dify 的「模型供应商」中安装 OpenAI-API-compatible 插件,添加模型时 API Base URL 填 https://api.niceai.dev/v1,填入 NiceAI 密钥和模型名,即可在应用和工作流中使用。
准备工作
- 一个可用的 Dify(云端或自部署)。
- 在 NiceAI 控制台「API 密钥」页面创建密钥,分组按所用模型选择。建议给 Dify 单独建一个密钥,方便查看用量。
配置步骤
- 进入 集成 → 模型供应商(不同版本也可能在「设置 → 模型供应商」)。
- 在 Marketplace 中找到 langgenius 发布的 OpenAI-API-compatible 插件并安装。
- 在插件卡片上点击 添加模型,按下表填写:
| 字段 | 填写内容 |
|---|---|
| 模型类型 | LLM |
| 模型名称 | 模型广场 中的模型名,会原样作为 model 发送 |
| API Key | 你的 NiceAI 密钥 |
| API Base URL(旧版叫 API endpoint URL) | https://api.niceai.dev/v1 |
| 对话类型 | 对话(Chat) |
| 模型上下文长度 | 按模型实际上下文填写 |
- 保存时 Dify 会发一个小请求验证凭据,通过后即可在应用中选用该模型。需要多个模型就逐个添加。
注意插件名称
Dify 官方插件仓库里还有一个把 Dify 应用转成 OpenAI 接口的扩展,名字相近但方向相反。接入 NiceAI 要装的是 模型供应商 类的 OpenAI-API-compatible。
常见问题
保存时提示 404?
API Base URL 要正好是 https://api.niceai.dev/v1,插件会自动拼接 /chat/completions。详见 接口地址要不要加 /v1。
工具调用或流式输出异常?
在模型设置中按模型能力调整 Function Call 和流式相关选项;不支持工具调用的模型不要开启。