feat: Support MinerU 4.1 Tasks API in the built-in MinerU document loader

问题场景

用户使用 Docker 部署的 Open WebUI v0.13.0，连接本地 MinerU 服务（http://localhost:8000），在知识库或文档上传流程中启用内置 MinerU 文档加载器，然后上传 PDF 文件进行解析。请求被转发到 MinerU 服务后返回 404，文档无法被解析。

报错原文

400: MinerU V1 API request failed: 404 Client Error: Not Found for url: http://localhost:8000/v1/uploads - {"detail":"Not Found"}

原因分析

最可能的原因是 MinerU 4.1 对 API 路径和调用方式做了破坏性变更，Open WebUI 内置加载器仍在按旧版接口约定请求 /v1/uploads 等路径。MinerU 4.1 迁移文档显示 Tasks API 的接口位置已调整，服务端不再在该路径提供对应端点，因此返回 404 Not Found。需要说明的是，Issue 讨论中并未直接贴出 MinerU 4.1 服务端的新端点清单，具体不匹配的字段或路径以官方迁移文档为准。此外，若 MinerU 服务以 --api-key 启动，还可能叠加鉴权不匹配问题（参见关联 Issue #32836）。

环境排查

• 确认 Open WebUI 版本：v0.13.0 是否包含对 MinerU 4.x 新 API 的支持。
• 确认 MinerU 版本：是否为 4.1 及以上的 Tasks API 版本，对照官方 migration_4_1 文档核对接口变更。
• 确认 Open WebUI 中 MinerU 加载器配置的服务地址是否为 http://localhost:8000，以及容器网络下该地址是否可达（Docker 部署时 localhost 可能指向容器自身而非宿主机）。
• 确认 MinerU 服务启动参数，是否设置了 --api-key，以及 Open WebUI 侧是否填入相同 API Key。
• Issue 未提供 Python、CUDA、PyTorch 等版本信息，如需进一步排查请以实际部署环境为准。

解决步骤

1. 先确认兼容性：查阅 Open WebUI 对应版本的更新说明，确认该版本内置 MinerU 加载器支持的是旧版接口还是 MinerU 4.x Tasks API。
2. 可优先尝试调整 MinerU 侧版本：若当前 Open WebUI 版本仅支持旧接口，可将 MinerU 降级到与该加载器兼容的版本，然后重启 MinerU 服务并重新上传 PDF 验证。
3. 可优先尝试升级 Open WebUI：若较新版本已适配 MinerU 4.x V1 接口（参考关联 Issue #31516 的讨论方向），升级到包含该适配的版本后再重试。
4. 若 MinerU 以 --api-key 启动，确保 Open WebUI 中 MinerU 配置的 API Key 与服务端一致，避免 404 之外再叠加 401。
5. 检查网络可达性：Docker 部署下将 localhost:8000 替换为宿主机可达地址或容器服务名，避免请求发到错误的主机。

验证方法

重新在 Open WebUI 中上传一个 PDF，观察是否仍出现 404 Client Error: Not Found for url: .../v1/uploads。若报错消失且文档解析结果正常返回，说明接口路径已匹配；若错误变为 401，则说明路径已通但鉴权仍需按上述第 4 步处理。

参考来源

open-webui/open-webui #33718

关联 Issue：#31516、#32836、#18479

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。