文档解析（Unlimited-OCR）

更新时间：2026-10-12

接口描述

文档解析（Unlimited-OCR）：基于 Unlimited-OCR 开源底座，通过标准化API服务，提供开箱即用、免部署的快捷接入方式，可直接返回 Json/Markdown 结构化输出，助您快速实现复杂文档智能解析。

接口限时免费，欢迎进行体验与咨询反馈！个人实名可获取免费测试资源200页，企业实名可获取免费测试资源1000页。

文档解析（Unlimited-OCR）API服务为异步接口，需要先调用提交请求接口获取 task_id，然后调用获取结果接口进行结果轮询，建议提交请求后 5～10 秒轮询。提交请求接口QPS为2，获取结果接口QPS为5。

在线调试

您可以在示例代码中心中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。

为方便您更好地使用文档解析服务，我们设立了专属交流群。您可通过下方二维码入群：

提交请求接口

请求说明

请求示例

HTTP 方法：POST

请求URL： https://aip.baidubce.com/rest/2.0/brain/online/v2/unlimited-ocr-parser/task

URL参数：

参数	值
access_token	通过API Key和Secret Key获取的access_token,参考“Access Token获取”

Header如下：

参数	值
Content-Type	application/x-www-form-urlencoded

Body中放置请求参数，参数详情如下：

请求参数

参数	是否必选	类型	可选值范围	说明
file_data	和file_url二选一	string	-	文件的base64编码数据： -版式文档：pdf、jpg、jpeg、png、bmp、tif、tiff、ofd，图片最长边不大于8192px -流式文档：doc、docx、txt、wps、ppt、pptx 图片不超过10M，版式文档大小不超过100M，流式文档大小不超过50M，其中PDF文档最大支持500页若文档大小超过50M，须从file_url方式上传。优先级： file_data > file_url，当file_data字段存在时，file_url字段失效
file_url	和file_data二选一	string	-	文件数据URL，URL长度不超过1024字节，支持单个URL传入 PDF文档大小不超过100M，最大支持500页优先级： file_data > file_url，当file_data字段存在时，file_url字段失效请注意关闭URL防盗链
file_name	是	string	-	文件名，请保证文件名后缀正确，例如 "1.pdf "
recognize_formula	-	bool	-	无需开启，大模型默认对版式类型文档进行公式识别
analysis_chart	否	bool	True/False	是否对统计图表进行解析，默认为False
parse_image_layout	-	bool	-	无需开启，大模型默认解析文档中的所有图片
language_type	-	string	-	无需开启，大模型默认识别语种类型
merge_tables	-	bool	-	是否将跨页表格合并输出，开启后tables内将返回跨页表格的合并标识，并将合并内容存放在table_html和markdown下，默认为False
relevel_titles	-	bool	-	是否对段落标题（paragraph_title）进行分级，开启后会在sub_type中输出对应的标题级别,默认为False
recognize_seal	-	bool	-	是否识别印章内容，默认为true；erase_seal=true 时被强制置false
return_span_boxes	-	bool	-	是否返回行坐标,默认为False
angle_adjust	-	bool	-	角度矫正，默认为true
angle_mode	-	string	-	角度矫正模式，开启角度矫正后生效，默认为 derection，可选： - direction：四方向 - arbitrary：任意方向
erase_seal	-	bool	-	印章擦除，默认为False；优先级高于 recognize_seal
erase_watermark	-	bool	-	水印擦除，默认为False
unwarp	-	bool	-	图像扭曲矫正，默认为False
page_filter	-	list[int]	-	指定页码进行解析，默认解析全部页数
need_pdffile_data	-	bool	-	是否返回整份PDF，默认为False
need_pdffile_vis_data	-	bool	-	当开启角度矫正、水印擦除等预处理能力后，是否输出处理后的PDF，默认为False

请求代码示例

提示：使用示例代码前，请记得替换其中的示例Token、文档地址或Base64信息。

Python

import base64
import os

import requests

API_KEY = "你的API_KEY"
SECRET_KEY = "你的SECRET_KEY"
FILE_PATH = "./test_sample/doc-0emc2uejide48tnp.jpg"


def get_access_token():
    url = "https://aip.baidubce.com/oauth/2.0/token"
    params = {
        "grant_type": "client_credentials",
        "client_id": API_KEY,
        "client_secret": SECRET_KEY,
    }
    return requests.get(url, params=params, timeout=30).json()["access_token"]


def create_task(url, file_path):
    with open(file_path, "rb") as f:
        file_data = base64.b64encode(f.read()).decode()

    data = {
        "file_data": file_data,
        "file_name": os.path.basename(file_path),
    }
    headers = {"Content-Type": "application/x-www-form-urlencoded"}
    return requests.post(url, headers=headers, data=data, timeout=120)


if __name__ == "__main__":
    access_token = get_access_token()
    url = (
        "https://aip.baidubce.com/rest/2.0/brain/online/v2/unlimited-ocr-parser/task"
        f"?access_token={access_token}"
    )
    response = create_task(url, FILE_PATH)
    print(response.json())

返回说明

返回参数

字段	类型	说明
log_id	uint64	唯一的log id，用于问题定位
error_code	int	错误码
error_msg	string	错误描述信息
result	dict	返回的结果列表
+ task_id	string	该请求生成的task_id，后续使用该task_id获取解析结果

返回示例

成功返回示例：

{
    "error_code": 0,
    "error_msg": "",
    "log_id": "10138598131137362685273505665433",
    "result": {
        "task_id": "task-3zy9Bg8CHt1M4pPOcX2q5bg28j26801S"
    }
}

失败返回示例（详细的错误码说明见API文档-错误码）：

{
    "error_code": 282003,
    "error_msg": "missing parameters",
    "log_id": "37507631033585544507983253924141",
    "result": "null"
}

获取结果接口