应优先选用 deepseek 官方 api 集成路径：在 dify 设置→模型供应商→deepseek 卡槽中粘贴完整未过期 api key（勿加 bearer 前缀），保存后出现 deepseek-v4-pro 等可选模型即成功；本地部署需用 host.docker.internal 或宿主 ip 对接 ollama，请求体须含 "stream": false 且 model 名与 ollama list 严格一致；夸克 ak/sk 必须配置在 deepseek 模型供应商页，联网搜索生效还需在应用编排中开启开关并连接工具调用分支；所有服务响应必须返回标准 choices[0].message.content 字段，否则 dify 静默失败。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
DeepSeek 与 Dify 集成不是“配对成功就行”，关键在于选对路径——官方 API、第三方 MaaS、本地部署，三者在可用性、延迟、数据主权上差异极大，不能混用或随意切换。
如何在 Dify 中正确添加 DeepSeek 官方 API 模型
这是最推荐的入门方式，前提是能稳定访问 https://api.deepseek.com/v1。Dify 会自动识别模型名，但必须确保填写的是完整且未过期的 API Key，而非仅 Token 或临时凭证。
- 进入 Dify 设置 → “模型供应商” → 点击 “DeepSeek” 卡槽，粘贴
API Key后点击保存，等待绿色校验提示（约 3–5 秒）； - 若提示
401 Unauthorized，检查是否误填了Bearer前缀——Dify 内部已自动封装，只需纯密钥； - 模型下拉菜单中出现
deepseek-v4-pro、deepseek-v4-flash等选项，说明集成成功；手动输入模型名无效，Dify 不支持自定义模型标识符； - 不建议在同一个模型供应商配置中混用多个 Key：Dify 的负载均衡仅在「多模型供应商」层级生效，单个 DeepSeek 条目下多 Key 无轮询效果。
本地部署 DeepSeek 时，Dify 怎么调用 Ollama 或 FastAPI 服务
Ollama 默认监听 http://localhost:11434，但 Dify 容器内无法直连宿主机的 localhost，必须用 host.docker.internal（Docker Desktop）或宿主机真实 IP（Linux）。
Unified LLM Gateway - One API for 70+ AI models. Route to GPT, Claude, Gemini, Qwen, Deepseek, Grok and more
下载
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
- 启动 Ollama 服务后，先在宿主机 curl 测试：
curl http://localhost:11434/api/tags确认模型已加载； - Dify 中添加自定义 LLM，API Base URL 填
http://host.docker.internal:11434/api/generate（Mac/Win）或http://172.17.0.1:11434/api/generate（Linux）； - 请求体模板中
"model"字段必须与ollama list输出的名称完全一致，例如deepseek-r1:7b-chat，多一个空格或大小写错误都会返回model not found； - Ollama 的
/api/generate接口默认流式响应，Dify 要求非流式，需在请求头中加{"stream": false}—— 这个字段必须写进 Dify 的「请求体模板」JSON 中，不能只靠界面开关。
启用联网搜索时，夸克 AccessKey 配在哪、怎么生效
夸克搜索不是插件，也不是模型层能力，而是 Dify 工作流中的一个「工具节点」。它的 AK/SK 必须绑定到 DeepSeek 模型供应商配置页，而非应用编排界面。
- 在 Dify 设置 → “模型供应商” → 找到已配置的 DeepSeek 条目 → 点击右侧“配置”按钮 → 填入
夸克搜索 AK和夸克搜索 SK； - 保存后，该 Key 会全局注入所有使用该 DeepSeek 模型的应用，无需在每个应用里重复设置；
- 真正触发联网搜索，是在应用编排页面开启「联网搜索」开关（右上角图标），且 LLM 节点必须连接了「工具调用」分支；单纯开启开关但没配置工具链路，模型仍走纯离线推理；
- 若测试时始终无搜索行为，检查 Dify 日志中是否出现
tool_call: search_web—— 没有该日志，说明提示词未触发工具调用，和 AK 是否有效无关。
最容易被忽略的一点：Dify 对 DeepSeek 的模型能力识别高度依赖响应格式一致性。无论是官方 API、Ollama 还是自建 FastAPI 服务，只要返回的 JSON 中缺少 choices[0].message.content 字段，或结构嵌套错层，Dify 就会静默失败，不报错也不输出。调试时务必用 curl 直接打 endpoint，比在 Dify 界面点“测试连接”更可靠。
