OCR智能批处理服务（推荐pdf加速版本）

一、请求参数

1. Body参数（JSON格式）

{
    "requestId": "28a9d5c4-2dae-4898-b90e-bbd38b31d62c",
    "serviceCode": "aigc-ocr-distribute",
    "aiParam": {
        "resourceUrl": "https://oss-cn-foshan-2.midea.com/wordtest/%E7%BA%AF%E6%96%87%E6%9C%AC%E8%A1%A8%E6%A0%BC2%E4%B8%87%E5%AD%9731%E9%A1%B5.pdf",
        "fileType": "pdf",
        "taskType": "common",
        "routerCode": "d-edp-ocr-pdf-page-api" //非必填字段
    }
}

字段名	必填	类型	说明
requestId	是	string	请求唯一ID，由用户自行设定，建议通过UUID生成
serviceCode	是	string	服务编码，固定：aigc-ocr-distribute
aiParam	是	object	输入参数集合
aiParam.resourceUrl	是	string	文档资源URL，若为PDF文件且设置了有效期，建议有效期2小时以上； 该URL需能与AI贵安集群网络互通，若不通需开通网络策略
aiParam.fileType	是	string	文件类型，可选值为["pdf", "png", "jpg", "jpeg"]
aiParam.taskType	是	string	任务类型，可选值为["markdown", "common", "common-json-md", "layout"]
aiParam.routerCode	否	string	默认为d-edp-ocr-pdf-page-api，私有化资源请咨询对应部署人获取code

 

---

二、响应参数

成功响应（HTTP 200）

//data为JSON 格式字符串，解析后为对象结构如下：
{
    "code": 0,
    "msg": "success",
    "info": [
        "数据量太大，用这个示例标识"
    ],
    "total_pages": 5,
    "pages_error_count": 0
}

响应字段说明

字段路径	类型	说明
code	int	业务状态码（0 = 操作成功）
msg	string	业务提示信息
data	string	核心数据（JSON 格式字符串，解析后为对象结构）
ok	boolean	接口请求是否成功标识（True = 成功）
data.code	int	数据层状态码（0 = 识别成功）
data.msg	string	数据层业务提示信息
data.info	array	文档提取结果集合，按段落维度分组
data.total_pages	int	文档的总页数
data.pages_error_count	int	处理失败的页数，0表示所有页面任务均执行成功，非0则存在部分页面处理失败

---

三、常见问题

1. 调用该接口时建议设置多长的超时时间？

答：接口为同步调用，PDF文件较大时处理耗时久，建议将调用方超时时间设置为300s以上。

 

2. 该接口对所有文件类型都提供加速处理吗？

答：当前PDF文件的加速处理，加速效果较为明显。对于png、jpg、jpeg的图片资源也支持处理，但不会为这类资源提供加速能力，因为本身响应就较快。

 

3. 如何判断文档所有页面都处理成功？

答：可校验响应字段中的`pages_error_count`，若该值为0则表示所有页面任务执行成功；非0则说明存在部分页面处理失败。

 

4. resourceUrl参数有什么特殊要求？

答：resourceUrl需为可访问的文档URL，若为PDF且有有效期建议设置2小时以上；同时该URL必须能与AI贵安集群网络互通，网络不通时需提前开通网络策略。

 

5. taskType参数的可选值分别对应什么能力？

答：taskType支持四个取值：markdown为markdown格式输出识别结果、common为常规JSON格式输出、common-json-md为JSON和MD双格式输出、layout为基于版面分析的识别结果输出，不建议在同步场景使用layout，会较慢

 

6.批处理服务原理

pdf多页拆分，拆分范围是4-10页，默认4页一个批次，通过架构优化，下层调度分发，上层聚合处理，可以提升数倍处理速度