文档矫正增强V2
更新时间：2026-09-18
接口描述
文档矫正增强V2公测上线，欢迎体验！
对试卷、卡证、票据等内容进行智能主体检测，自动定位四角并精准提取主体内容，完成高精度透视矫正。V2 版本全面升级，支持图片增强、进一步锐化文字笔画、提升画面清晰度，让主体内容检测、矫正增强一步到位。
V2主要提升
- 新增方向转正参数
enable_ori：适用于拍摄角度不正的场景，例如文档被横拍、倒置或旋转了一定角度，开启后自动识别并还原正确朝向，无需手动调整。 - 清晰度提升：文字更清晰锐利，小字、浅色字、边角处的内容都更容易辨认，局部模糊区域也有明显改善。
- 版面更平整：褶皱、扭曲得到更好的拉直处理，文字行更齐，段落、表格看起来更规整自然。
- 内容不丢失：在矫正增强的同时保留原始内容，不丢字、不吞边。
公测期间可获取免费测试额度
- 个人实名：免费测试资源 500 次
- 企业实名：免费测试资源 1000 次
在线调试
您可以在 示例代码中心 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP 方法: POST
请求URL: https://aip.baidubce.com/rest/2.0/ocr/v1/doc_crop_enhance_v2
URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header如下：
| 参数 | 值 |
|---|---|
| Content-Type | application/x-www-form-urlencoded |
Body中放置请求参数，参数详情如下：
请求参数
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| image | string | 和 url/pdf_file 三选一 | 图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少15px，最长边最大4096px，支持jpg/jpeg/png/bmp格式 优先级：image > url > pdf_file，当image字段存在时，url、pdf_file字段失效 |
| url | string | 和 image/pdf_file 三选一 | 图片完整url，url长度不超过1024字节，url对应的图片base64编码后大小不超过4M，最短边至少15px，最长边最大4096px，支持jpg/jpeg/png/bmp格式 优先级：image > url > pdf_file，当image字段存在时，url字段失效 请注意关闭URL防盗链 |
| pdf_file | string | 和 image/url 三选一 | PDF文件，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少15px，最长边最大4096px 优先级：image > url > pdf_file，当image、url字段存在时，pdf_file字段失效 |
| pdf_file_num | string | 否 | 需要识别的PDF文件的对应页码，当 pdf_file 参数有效时，识别传入页码的对应页面内容，若不传入，则默认识别第 1 页 |
| scan_type | int32 | 否 | 选择是否对图片内主体内容进行四角点增强或矫正，可选值如下： - scan_type = 1：只做检测，不对主体进行矫正，返回主体四角点坐标，可用作前端页面展示 - scan_type = 2：默认值，检测并矫正，返回主体在原图中的四角点坐标以及矫正后的图像 |
| enhance_type | int32 | 否 | 选择是否开启图像增强功能，如开启可选择增强效果，可选值如下： - enhance_type =0：默认值，不开启增强功能 - enhance_type = 1：增强并锐化 |
| enable_ori | int32 | 否 | 选择是否开启图像方向转正功能，可选值如下： - enable_ori=0，默认值，不开启转正； - enable_ori=1，开启转正 |
返回说明
返回参数
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| log_id | uint64 | 是 | 唯一的log id，用于问题定位 |
| image_processed | string | 是 | 返回处理后的图片 |
| points | array[] | 否 | 检测到的图片内主体在原图中的四角点坐标，顺序固定为左上、左下、右下、右上。坐标系为上传的原图，可直接用于在原图上绘制 |
| pdf_file_size | string | 否 | 传入PDF文件的总页数，当 pdf_file 参数有效时返回该字段 |
返回示例
JSON
1{
2 "image_processed":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQYFBACUoKSj/2w"
3 "points": [
4 {
5 "x": 462,
6 "y": 122
7 },
8 {
9 "x": 305,
10 "y": 1521
11 },
12 {
13 "x": 1745,
14 "y": 1406
15 },
16 {
17 "x": 1341,
18 "y": 196
19 }
20 ],
21 "log_id": 2098017318853891227
22}评价此篇文章