全文识别高精版

调试

您可以在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调用此接口的示例请参考开发者中心