api 只支持返回压缩包链接？

[Bin1783]

{
"code": 0,
"msg": "ok",
"trace_id": "9d89f1a259d946ac4df03614a9c72c3b",
"data": {
"task_id": "fce43241-6ed2-4207-9a7e-606245ee7dd6",
"state": "done",
"err_msg": "",
"full_zip_url": "https://cdn-mineru.openxlab.org.cn/pdf/2026-01-12/fce43241-6ed2-4207-9a7e-606245ee7dd6.zip"
}
} 官方api 不支持返回解析后的文件吗

[dosubot[bot]]

Hi @Bin1783! I'm Dosu and I’m helping the MinerU team.

官方 API 支持返回解析后的文件，但具体方式取决于你用的是哪个接口和参数设置：

• 如果你用的是批量上传/解析接口（比如你展示的这种返回 full_zip_url 的 API），目前只支持返回解析结果的压缩包下载链接，不能直接在响应里拿到解析后的文件内容（比如 markdown、json 等）——需要自己下载并解压 zip 文件查看结果。相关讨论

• 如果你用的是 /file_parse 这个接口，可以通过参数控制返回格式：

  • 设置 response_format_zip=true，API 会返回包含所有解析结果的 zip 文件。
  • 设置 response_format_zip=false 并指定 return_md=true、return_middle_json=true 等参数，API 会直接在响应 JSON 里返回解析后的内容，比如 markdown 文本、json、图片（base64）等。接口参数说明 代码实现

目前批量接口不支持直接返回解析后的文件内容，只能通过下载 zip 包获取。如果你需要直接拿到解析内容，建议用 /file_parse 接口并设置合适参数。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[Bin1783]

是只有本地部署才有这个接口吗？ 官方不提供这个接口是吧

[dosubot[bot]]

是的，/file_parse 这个接口（支持直接返回解析内容，比如 markdown、json、图片等）目前只在 MinerU 的本地部署（自托管）版本里开放，官方在线 API 并不提供这个接口。官方 API 只支持返回解析结果的压缩包下载链接（full_zip_url），不能直接在响应里拿到解析后的文件内容，需要下载并解压 zip 文件查看结果。

官方 API 和本地 mineru-api 的接口定义、参数和认证方式是分开的，未来有计划统一，但现在还没有实现。相关说明 接口实现

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[Bin1783]

直接运行compose 提示仓库不存在 什么原因 只能源码部署吗

[dosubot[bot]]

你遇到“pull access denied for mineru, repository does not exist or may require 'docker login'”的原因是 MinerU 没有提供公开的 Docker 镜像仓库，Docker Compose 无法自动拉取镜像。官方的部署方式是让你先用官方提供的 Dockerfile 在本地自行构建镜像，然后再用 compose.yaml 启动服务。

操作流程如下：

1. 下载官方 Dockerfile（可选国内/国际源）和 compose.yaml 文件。
2. 在本地构建镜像，例如：

   wget https://gcore.jsdelivr.net/gh/opendatalab/MinerU@master/docker/global/Dockerfile
   docker build -t mineru:latest -f Dockerfile .

3. 下载 compose.yaml 文件：

   wget https://gcore.jsdelivr.net/gh/opendatalab/MinerU@master/docker/compose.yaml

4. 用 Docker Compose 启动服务（比如 Web API）：

   docker compose -f compose.yaml --profile api up -d

详细说明和注意事项见官方文档。

所以不是只能源码部署，但需要你本地 build 镜像，不能直接 pull 镜像。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[nuocheng]

Hi @Bin1783! I'm Dosu and I’m helping the MinerU team.

官方 API 支持返回解析后的文件，但具体方式取决于你用的是哪个接口和参数设置：

• 如果你用的是批量上传/解析接口（比如你展示的这种返回 full_zip_url 的 API），目前只支持返回解析结果的压缩包下载链接，不能直接在响应里拿到解析后的文件内容（比如 markdown、json 等）——需要自己下载并解压 zip 文件查看结果。相关讨论

• 如果你用的是 /file_parse 这个接口，可以通过参数控制返回格式：

  • 设置 response_format_zip=true，API 会返回包含所有解析结果的 zip 文件。
  • 设置 response_format_zip=false 并指定 return_md=true、return_middle_json=true 等参数，API 会直接在响应 JSON 里返回解析后的内容，比如 markdown 文本、json、图片（base64）等。接口参数说明 代码实现

目前批量接口不支持直接返回解析后的文件内容，只能通过下载 zip 包获取。如果你需要直接拿到解析内容，建议用 /file_parse 接口并设置合适参数。

To reply, just mention @dosu.

How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other

   

mineru版本：{ "backend": "vlm-vllm-async-engine", "version": "3.0.9",}
使用 compose.yaml启动api服务
post 请求 http://192.168.88.24:8000/tasks
请求参数：files， output_dir, backend
我想获取zip的下载地址（包含content_list, layout,model.json）但是我在请求参数中加入了response_format_zip后，返回的是md的zip文件，并不是我想要的
我在 gradio中运行，是能下载到这个zip文件的，我的请求方式如何调整才能下载到这个zip文件