分类: Dify 教程

Dify 接入 DeepAI、OpenAI Compatible 模型供应商、工作流、知识库和错误排查。

Dify deepai openai compatible localhost connection refused.png

Dify 接入 DeepAI API 中转站:OpenAI-API-compatible 的 localhost 连接失败排查Dify 接入 DeepAI API 中转站:OpenAI-API-compatible 的 localhost 连接失败排查

Dify 通过 OpenAI-API-compatible 接入 LiteLLM、DeepAI API 中转站或本地代理时,curl 本机可用但 Dify 校验报 localhost connection refused,通常是网络可达性问题。本文结合 Dify Issue #4460 整理 Cloud、Docker、自托管场景下的 Base URL 排查方法。

Dify deepai max completion tokens reasoning model.png

Dify 接入 DeepAI API 中转站:max_tokens 不支持改用 max_completion_tokensDify 接入 DeepAI API 中转站:max_tokens 不支持改用 max_completion_tokens

Dify 使用 OpenAI-API-compatible Provider 接入 o1、GPT-5 或其他 reasoning 模型时,如果模型校验或运行报 Unsupported parameter: max_tokens,通常要改用 max_completion_tokens。本文结合 Dify Issue #10348、官方插件 Issue #1845 和 PR #2713/#2771,整理 DeepAI API 中转站场景下的排查与修复方法。

Dify deepai tool calling array schema missing items.png

Dify 接入 DeepAI API 中转站:Tool Calling 报 array schema missing items 怎么排查Dify 接入 DeepAI API 中转站:Tool Calling 报 array schema missing items 怎么排查

Dify 自定义工具接入 OpenAI 插件或 API 中转站时,如果 Tool Calling 报 invalid_function_parameters:array schema missing items,根因通常不是 Key 或 Base URL,而是工具 JSON Schema 的 array 参数缺少 items。本文结合 Dify GitHub Issue #32894 和 PR #33137,整理排查步骤、修复示例与

Dify deepai custom embedding knowledge base empty.png

Dify 接入 DeepAI API 中转站:自定义 Embedding 后知识库为空怎么排查Dify 接入 DeepAI API 中转站:自定义 Embedding 后知识库为空怎么排查

Dify 自托管使用 OpenAI-compatible Embedding Provider 时,API 手动测试成功但知识库处理后为空怎么办?本文结合 Dify GitHub 已关闭 Issue,整理 DeepAI API 中转站、Docker 网络、默认 LLM、分段长度和 documents 表错误排查方法。

Dify deepai openai compatible 404 401 tool calling.png

Dify 接入 DeepAI API 中转站:OpenAI-Compatible 404、401 与工具调用 400 排查Dify 接入 DeepAI API 中转站:OpenAI-Compatible 404、401 与工具调用 400 排查

Dify 添加 OpenAI-compatible 模型时遇到 404、401 或 vLLM tool choice 400 怎么办?本文结合 Dify GitHub 已关闭 Issue,整理 Base URL、API Key、模型验证和工具调用的排查顺序。