Dify 自定义大模型 API 插件配置教程
区分 Dify 模型插件版本:OpenAI 1.1.0+ 填 /v1 配 Responses,Anthropic 0.3.41+ 填站根,其余模型走兼容插件
Dify 怎么接入 DeepClub?
先确认 Dify 插件市场里的供应商插件版本(主程序版本不能替代插件版本),再按模型推荐协议选择插件与地址。
- 登录 DeepClub,在「API 密钥」页面创建密钥(`sk-...`)。
- GPT 文本与 Grok:安装或升级官方 OpenAI 插件(核对
1.1.0+),添加自定义 LLM,API Base URL 填https://deepclub.net/v1,API Protocol 选择 Responses API,模型名填目录精确 ID(如gpt-6.1-sol)。 - Claude 系列:安装官方 Anthropic 插件(核对
0.3.41+),API Base URL 填站根https://deepclub.net(不带/v1),填入精确 ID(如claude-sonnet-5-5)。 - DeepSeek / Gemini 文本 / GLM / Kimi / Qwen:使用 OpenAI-API-compatible 插件(Base URL 填
https://deepclub.net/v1),模型类型选LLM、Completion mode 选Chat。
为什么 openai_api_compatible 还要注意版本与校验请求?
部分版本 openai_api_compatible(例如 0.0.83)虽然可选 API Type=Responses API,但其凭据校验阶段仍可能向 /v1/chat/completions 发请求。
| Dify 场景 | 推荐插件方案 | Base URL |
|---|---|---|
| GPT-6 / Grok 原生 Responses | 官方 OpenAI 插件 (1.1.0+) |
https://deepclub.net/v1 |
| Claude 5.x 原生 Messages | 官方 Anthropic 插件 (0.3.41+) |
https://deepclub.net |
| DeepSeek / Gemini / GLM / Kimi / Qwen | OpenAI-API-compatible | https://deepclub.net/v1 |
在 Workflow 节点中选择配置好的模型并运行一条测试对话,到 DeepClub 控制台 与使用日志核对实际调用模型与用量;所有实时价格见 定价页。更多多协议原理可参考 OpenAI SDK 与协议对照。
常见问题
- Dify 添加 Anthropic 插件时 Base URL 要不要带 /v1?
- 不要带 /v1,填写站根 https://deepclub.net。若误加 /v1 会拼出 /v1/v1/messages 导致 404。
- Dify 官方 OpenAI 插件怎么启用 Responses API?
- 升级到 OpenAI 插件 1.1.0 或更高版本后,在添加自定义 LLM 时把 API Base URL 设为 https://deepclub.net/v1,并将 API Protocol 选为 Responses API。
- Dify 知识库 RAG / 路由节点推荐什么模型?
- 轻量入口分类或翻译节点可选 gpt-6-luna、gemini-4-hydrogen 或 glm-5.3-flash;代码与复杂推理节点可选 claude-sonnet-5-5、gpt-6.1-sol 或 deepseek-v4.1-flash,实时单价见 /pricing。
更新于