Dify 添加 巨蓝鲸AI 自定义模型
官方入口:Dify 中文官网使用与部署入口
适用范围:Dify 的 OpenAI-API-compatible 模型提供商;需要工作区管理员权限,先验证 LLM 文字对话。
版本与验证:截图为既有模型供应商界面,未标版本。已核对官方插件的 API Base URL 字段;Dify 与提供商插件版本都需要记录。
配置速查
| 配置项 | 填写内容 | 注意事项 |
|---|---|---|
| 模型供应商 | OpenAI-API-compatible | 未安装时先在模型供应商或插件市场安装对应插件。 |
| API Base URL | https://api.julanjing.com/v1 | 旧图为根地址写法;此处明确填写 /v1,勿加 /chat/completions。 |
| 模型类型 / 对话类型 | LLM / Chat | 不要选 Embedding 或 Completion 来测试聊天。 |
| 模型名称 / API Key | 实际模型 ID / 巨蓝鲸AI API Key | 显示名称与实际请求名称不同的版本需检查两个字段。 |
还没有 API Key?注册获取免费体验额度 · 已注册:进入控制台创建 API Key
为此工具单独创建令牌,并设置合理额度和模型权限。截图中的模型仅作示例,以账号当前可用模型为准;不要公开密钥或上传含密钥的配置文件。
本教程在 Dify 中添加 巨蓝鲸AI 提供的文字模型,再将它用于应用或工作流。需要有管理模型供应商的工作区权限。
第 1 步:进入模型供应商
打开工作区设置的模型供应商;新版界面也可能在 Integrations → Model Provider。确认当前工作区正确。

第 2 步:选择 OpenAI-API-compatible
已有插件直接配置,未安装时从模型供应商或插件市场安装。不要把本例参数填入其他协议的供应商。

第 3 步:填写模型与凭证
模型类型选择 LLM,对话类型选择 Chat。填写实际模型 ID 和 巨蓝鲸AI API Key;API Base URL 填 https://api.julanjing.com/v1。下图为旧界面,地址和模型名以本页配置表为准;不要复制截图中的密钥。

第 4 步:在应用中选中模型
保存后,在应用或工作流的 LLM 节点明确选择刚添加的模型。系统默认模型设置不一定覆盖节点原有选择。

第 5 步:执行一次短文本测试
发送一条不含隐私数据的短消息,检查应用输出和 巨蓝鲸AI 调用记录。先跑通基础文字对话,再配置知识库、工具或其他高级能力。

怎样确认配置已生效
- 在模型供应商中保存凭证并完成验证。
- 在应用或工作流 LLM 节点明确选择新模型,发送短文本并查看节点输出。
- 同时检查控制台请求日志,确认不是工作区默认模型或其他凭证回退。
接入失败时逐项检查
| 现象 | 检查与处理 |
|---|---|
| 没有添加模型权限 | 请工作区 owner 或管理员配置;不是 API Key 无效。 |
| 保存成功但节点报错 | 检查节点实际选中的模型、变量输入和消息内容,凭证成功不代表工作流输入正确。 |
| 服务端连接超时 | 从 Dify 后端/插件运行环境检查网络;本机浏览器能访问不代表容器能访问。 |
| 400 参数不支持 | 先关闭未经验证的结构化输出、工具或推理参数,以短文本基础调用定位。 |
资料与下一步
遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。