直接填对api地址和密钥即可使用，但多数人卡在base_url格式（必须为https://api.deepseek.com/v1）、认证方式（key须来自platform.deepseek.com）及模型名（必须为deepseek-v4-pro）三处。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

直接填对 API 地址和密钥就能用，但多数人卡在 base_url 格式、认证方式或模型名不匹配这三处。

确认 DeepSeek 的 API 兼容层是否启用

DeepSeek 官方 API（https://api.deepseek.com/v1）本身是 OpenAI 兼容格式，但 Dify 的「自定义模型」入口默认走 OpenAI 协议栈，必须确保：

• 你申请的 API Key 来自 https://platform.deepseek.com，不是百炼或 DashScope；百炼渠道需改用通义千问插件，不能直连 DeepSeek 模型
• Dify 版本 ≥ 0.15.0（旧版会忽略 extra_body 参数，导致 enable_thinking 失效）
• 若使用阿里云百炼提供的 DeepSeek 模型，Dify 中必须启用「通义千问插件」，而非填写 DeepSeek 原生地址

在 Dify 控制台填什么参数才有效

Dify 的「模型供应商 → 自定义模型」表单里，以下字段必须严格按格式填写，错一个就报 401 Unauthorized 或 model not found：

One API key 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等主流模型。

下载

• API Base URL：填 https://api.deepseek.com/v1（结尾不能漏 /v1，否则 Dify 会拼出错误路径）
• API Key：直接粘贴从 DeepSeek 平台复制的密钥，不要加 sk-xxx 以外的前缀或空格
• Model Name：填 deepseek-v4-pro（不是 deepseek-chat 或 deepseek-coder，后者已弃用）
• Supports Streaming：勾选（DeepSeek v4-pro 支持流式响应，Dify 需据此调整解析逻辑）

启用思考模式（enable_thinking）的实操要点

DeepSeek-v4-pro 的思考链能力需显式开启，但 Dify 默认不透传非标准参数。你必须在 Dify 的「高级设置」中手动注入：

• 打开模型配置页 → 「高级设置」→ 勾选「启用额外请求参数」
• 在 JSON 输入框中填：{"enable_thinking": true}（注意是布尔值 true，不是字符串 "true"）
• 若同时想控制推理强度，可加 "reasoning_effort": "high"，但该参数仅在流式响应中生效
• 验证是否生效：发一条测试 prompt，观察返回的 delta.reasoning_content 字段是否非空

本地部署 Dify 时的超时与内存坑

如果你用 Docker Compose 在本地跑 Dify + DeepSeek（比如调试阶段），别忽略两个硬性限制：

• Dify 默认 REQUEST_TIMEOUT 是 60 秒，但 DeepSeek-v4-pro 在 RTX 3090 上首次加载可能耗时 70+ 秒，需在 .env 文件里改 REQUEST_TIMEOUT=120
• Dify 的 ARRAY_MAX_SIZE 默认 1000，遇到长文档分块处理易爆内存，建议调到 5000 并确保宿主机有 ≥32GB RAM
• 本地运行时，Dify 日志里若出现 ConnectionResetError 或 ReadTimeout，八成是超时没调，而不是网络问题

最常被忽略的是模型名大小写和 API 地址末尾的 /v1 —— 这俩错一个，Dify 就静默 fallback 到空响应，连 error log 都不打全。