创建PDF解析任务（官方免费版）

正式环境

https://api.302.ai

POST

/mineru/api/v4/extract/task

文档参考： https://mineru.net/apiManage/docs

📌 功能说明
该接口用于解析指定 URL 对应的文档，支持 OCR 识别、公式/表格提取、多格式导出等功能，可通过回调通知或定时轮询获取解析结果，适用于多种类型文档的结构化解析场景。

⚠️ 用前必读

HTML 文件解析必须明确指定 model_version为 "MinerU-HTML"，非 HTML 文件则可根据需求选择 pipeline 或 vlm 版本

单个文件大小不能超过 200MB，文件页数不超出 600 页

因网络限制，github、aws 等国外 URL 会请求超时

该接口不支持文件直接上传

📝 使用步骤

在此接口设置基础参数后发送请求获取task_id

前往任务查询接口填写task_id获取结果

🔑 关键注意事项

必填参数校验：url 和 model_version 为必填项，缺少将导致接口调用失败；使用 callback 时必须配套提供 seed 参数。

页码范围格式：支持单个页码、连续页码区间（如 4-6）、倒数页码（如 -2 表示倒数第二页），多规则用逗号分隔。

导出格式说明：默认导出 markdown 和 json 格式，额外导出格式仅支持 docx、html、latex 中的一种或多种，通过 extra_formats 数组指定。

💰 价格
限时免费，每日额度有限，用完即止

请求参数

Header 参数

Body 参数application/json

示例

vlm模式MinerU-HTML模式（解析Html文件）

{
    "url": "https://cdn-mineru.openxlab.org.cn/demo/example.pdf",
    "model_version": "vlm"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

vlm模式MinerU-HTML模式（解析Html文件）

curl --location --request POST 'https://api.302.ai/mineru/api/v4/extract/task' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://cdn-mineru.openxlab.org.cn/demo/example.pdf",
    "model_version": "vlm"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "msg": "ok",
    "trace_id": "79dd6fcac0f4b7e0a21fcc56854329a2",
    "data": {
        "task_id": "a4379d13-95e2-4af1-aae4-04fe5d6fc4cf"
    }
}

修改于 2026-01-23 02:13:49

查看PDF解析任务（开源部署版）

查看PDF解析任务（官方免费版）