全文识别高精版
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | RecognizeAdvanced |
系统规定参数。取值:RecognizeAdvanced。 |
| Url | String | 否 | https://img.alicdn.com/tfs/TB1Wo7eXAvoK1RjSZFDXXXY3pXa-2512-3509.jpg |
图片链接(长度不超 2048,不支持 base64)。 |
| String | 否 | 图片二进制文件 |
图片二进制文件,最大10MB,与URL二选一。 使用HTTP方式调用,把图片二进制文件放到HTTP body 中上传即可。 使用SDK的方式调用,把图片放到SDK的body中即可。 |
|
| OutputCharInfo | Boolean | 否 | false |
是否输出单字识别结果。 |
| NeedRotate | Boolean | 否 | false |
是否需要自动旋转功能(结构化检测、混贴场景、教育相关场景会自动做旋转,无需设置),返回角度信息。 |
| OutputTable | Boolean | 否 | false |
是否输出表格识别结果,包含单元格信息。 |
| NeedSortPage | Boolean | 否 | false |
是否按顺序输出文字块。false表示从左往右,从上到下的顺序;true表示从上到下,从左往右的顺序。 |
| OutputFigure | Boolean | 否 | false |
是否需要图案检测功能,默认不需要。true:需要 false:不需要 |
| NoStamp | Boolean | 否 | false |
是否需要去除印章功能,默认不需要。true:需要 false:不需要 |
| Paragraph | Boolean | 否 | false |
是否需要分段功能,默认不需要。true:需要 false:不需要 |
| Row | Boolean | 否 | false |
是否需要成行返回功能,默认不需要。true:需要 false:不需要 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 43A29C77-405E-4CC0-BC55-EE694AD00655 |
请求唯一 ID |
| Data | String | { "content": "2017年河北区实验小学", "height": 3509, "orgHeight": 3509, "orgWidth": 2512, "prism_version": "1.0.9", "prism_wnum": 126, "prism_wordsInfo": [{ "angle": -89, "direction": 0, "height": 541, "pos": [{ "x": 982, "y": 223 }, { "x": 1522, "y": 223 }, { "x": 1522, "y": 266 }, { "x": 982, "y": 266 }], "prob": 99, "width": 43, "word": "2017年河北区实验小学", "x": 1230, "y": -26 }], "width": 2512 } |
返回数据 |
| Code | String | 200 |
状态码 |
| Message | String | message |
详细信息 |
示例
请求示例
http(s)://ocr-api.cn-hangzhou.aliyuncs.com/?Action=RecognizeAdvanced
&Url=https://img.alicdn.com/tfs/TB1Wo7eXAvoK1RjSZFDXXXY3pXa-2512-3509.jpg
&OutputCharInfo=false
&NeedRotate=false
&OutputTable=false
&NeedSortPage=false
&公共请求参数
正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RecognizeAdvancedResponse>
<RequestId>43A29C77-405E-4CC0-BC55-EE694AD00655</RequestId>
<Data>{ "content": "2017年河北区实验小学", "height": 3509, "orgHeight": 3509, "orgWidth": 2512, "prism_version": "1.0.9", "prism_wnum": 126, "prism_wordsInfo": [{ "angle": -89, "direction": 0, "height": 541, "pos": [{ "x": 982, "y": 223 }, { "x": 1522, "y": 223 }, { "x": 1522, "y": 266 }, { "x": 982, "y": 266 }], "prob": 99, "width": 43, "word": "2017年河北区实验小学", "x": 1230, "y": -26 }], "width": 2512 }</Data>
</RecognizeAdvancedResponse>
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "43A29C77-405E-4CC0-BC55-EE694AD00655",
"Data" : "{ \t\"content\": \"2017年河北区实验小学\", \t\"height\": 3509, \t\"orgHeight\": 3509, \t\"orgWidth\": 2512, \t\"prism_version\": \"1.0.9\", \t\"prism_wnum\": 126, \t\"prism_wordsInfo\": [{ \t\t\"angle\": -89, \t\t\"direction\": 0, \t\t\"height\": 541, \t\t\"pos\": [{ \t\t\t\"x\": 982, \t\t\t\"y\": 223 \t\t}, { \t\t\t\"x\": 1522, \t\t\t\"y\": 223 \t\t}, { \t\t\t\"x\": 1522, \t\t\t\"y\": 266 \t\t}, { \t\t\t\"x\": 982, \t\t\t\"y\": 266 \t\t}], \t\t\"prob\": 99, \t\t\"width\": 43, \t\t\"word\": \"2017年河北区实验小学\", \t\t\"x\": 1230, \t\t\"y\": -26 \t}], \t\"width\": 2512 }"
}
返回示例补充说明
返回数据说明
angle 图片的角度,当NeedRotate为true时才会返回,0表示正向,90表示图片朝右,180朝下,270朝左
content 识别出图片的文字块汇总
height 算法矫正图片后的高度
width 算法矫正图片后的宽度
orgHeight 原图的高度
orgWidth 原图的宽度
prism_wnum 识别的文字块的数量,prism_wordsInfo数组的大小
--------------------------prism-wordsInfo文字块数组内的字段说明--------------------------
angle 文字块的角度,这个角度只影响width和height,当角度为-90、90、-270、270,width和height的值需要自行互换
height 文字块的高度
width 文字块的宽度
pos 文字块的外矩形四个点的坐标按顺时针排列,左上、右上、右下、左下,当NeedRotate为true时,如果最外层的angle不为0,需要按照angle矫正图片后,坐标才准确
word 文字块的文字
tableId 当OutputTable为true并且该文字块在表格内则存在该字段,tableId表示表格的id
tableCellId 当OutputTable为true并且该文字块在表格内则存在该字段,表示表格中单元格的id
-----------------------------------------charInfo单字信息-------------------------------------------
word 单字文字
prob 置信度
x 单字左上角横坐标
y 单字左上角纵坐标
w 单字宽度
h 单字高度
-----------------------------------------------------------------------------------------------------------
-----------------------------------------------------------------------------------------------------------
----------------------------prism-tablesInfo表格数组内的字段说明---------------------------
tableId 表格id,和prism_wordsInfo信息中的tableId对应
xCellSize 表格中横坐标单元格的数量
yCellSize 表格中纵坐标单元格的数量
-------------cellInfos单元格信息,包含单元格在整个表格中的空间拓扑关系-----------
tableCellId 表格中单元格id,和prism_wordsInfo信息中的tableCellId对应
word 单元格中的文字
xsc xStartCell缩写,表示横轴方向该单元格起始在第几个单元格,第一个单元格值为0
xec xEndCell缩写,表示横轴方向该单元格结束在第几个单元格,第一个单元格值为0,如果xsc和xec都为0说明该文字在横轴方向占据了一个单元格并且在第一个单元格内
ysc yStartCell缩写,表示纵轴方向该单元格起始在第几个单元格,第一个单元格值为0
yec yEndCell缩写,表示纵轴方向该单元格结束在第几个单元格,第一个单元格值为0
pos 单元格位置,按照单元格四个角的坐标顺时针排列,分别为左上XY坐标、右上XY坐标、右下XY坐标、左下XY坐标
-----------------------------------------------------------------------------------------------------------
-----------------------------------------------------------------------------------------------------------
错误码
访问错误中心查看更多错误码。
SDK调用
通过SDK调用此接口的示例请参考开发者中心