Dify 自定义大模型 API 插件配置教程

区分 Dify 模型插件版本:OpenAI 1.1.0+ 填 /v1 配 Responses,Anthropic 0.3.41+ 填站根,其余模型走兼容插件

Dify 怎么接入 DeepClub?

先确认 Dify 插件市场里的供应商插件版本(主程序版本不能替代插件版本),再按模型推荐协议选择插件与地址。

  1. 登录 DeepClub,在「API 密钥」页面创建密钥(`sk-...`)。
  2. GPT 文本与 Grok:安装或升级官方 OpenAI 插件(核对 1.1.0+),添加自定义 LLM,API Base URL 填 https://deepclub.net/v1,API Protocol 选择 Responses API,模型名填目录精确 ID(如 gpt-6.1-sol)。
  3. Claude 系列:安装官方 Anthropic 插件(核对 0.3.41+),API Base URL 填站根 https://deepclub.net(不带 /v1),填入精确 ID(如 claude-sonnet-5-5)。
  4. 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。

更新于