阿里云-通用文字识别－高精版

通用文字识别－高精版

接口地址：http://route.showapi.com/2023-1 （注意：接口支持https，更安全，但稍慢一些，你懂的。请根据自己的情况进行选择。）

支持格式：json

请求方法：HTTP协议，支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时，enctype=application/x-www-form-urlencoded。 
文件上传的POST时，enctype=multipart/form-data。 

1、系统级参数（所有接入点都需要的参数）： 

参数名称	类型	示例值	必须	描述
showapi_appid	String	100	是	易源应用id
showapi_sign	String	698d51a19d8a121ce581499d7b701668	是	为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp	String	20141114142239	否	客户端时间。  格式yyyyMMddHHmmss,如20141114142239  为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。
showapi_res_gzip	String	1或0	否	返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。
...

2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起 

参数名称	类型	默认值	示例值	必须	描述
img	String			否	图片二进制数据的base64编码或者图片url 注意传base64时:data:image/png;base64,要去掉
url	String		https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/wjy/%E7%B2%BE%E5%87%86%E6%96%87%E5%AD%97.jpg	否	图像url地址：图片完整URL，URL长度不超过1024字节，URL对应的图片base64编码后大小不超过4M，最短边至少15px，最长边最大4096px，支持jpg/png/bmp格式，和img参数只能同时存在一个
...

请求示例：String res=new ShowApiRequest("http://route.showapi.com/2023-1","my_appId","my_appSecret") .addTextPara("img","") .addTextPara("url"," https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/wjy/%E7%B2%BE%E5%87%86%E6%96%87%E5%AD%97.jpg") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数（所有接入点都会返回的参数）： 展开收起 

名称	类型	示例值	描述
showapi_res_body	String	{"city":"昆明","prov":"云南"}	消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。
showapi_res_code	int	0	易源返回标志,0为成功，其他为失败。 0成功 -1，系统调用错误 -2，可调用次数或金额为0 -3，读取超时 -4，服务端返回数据解析错误 -5，后端服务器DNS解析错误 -6，服务不存在或未上线 -7, API创建者的网关资源不足 -1000，系统维护 -1002，showapi_appid字段必传 -1003，showapi_sign字段必传 -1004，签名sign验证有误 -1005，showapi_timestamp无效 -1006，app无权限调用接口  -1007，没有订购套餐 -1008，服务商关闭对您的调用权限 -1009，调用频率受限 -1010，找不到您的应用 -1011，子授权app_child_id无效 -1012，子授权已过期或失效 -1013，子授权ip受限 -1014，token权限无效
showapi_res_error	String	用户输入有误!	错误信息的展示
showapi_res_id	String	ce135f6739294c63be0c021b76b6fbff	本次请求id
...

2、应用级参数（系统级输出参数showapi_res_body字段中的json数据结构）： 展开收起 

名称	类型	示例值	描述
sid	String	31ccf0fa90b40423b8bf4fc2f0b50f05f036eb49b3d76b5b50a65fd356292a0855488b86	唯一id，用于问题定位
prism_version	String	1.0.9	算法版本
prism_wnum	Number	11	识别的文字块的数量，prism_wordsInfo数组大小
angle	Number	0	角度 : 范围：0-360,0表示向上，90表示向右，180表示向下，270度表示向左
prism_wordsInfo	Object[]		角度， "angle": 范围：0-360,0表示向上，90表示向右，180表示向下，270度表示向左
-  0	Object
-  word	String	大学生心理健康日的由来	文字块
-  prob	Number	99	置信度
-  pos	Object[]		文字块的位置，按照文字块四个角的坐标顺时针排列，分别为左上XY坐标、右上XY坐标、右下XY坐标、左下XY坐标
-  0	Object
-  x	Number	30
-  y	Number	101
-  1	Object
-  x	Number	758
-  y	Number	110
-  2	Object
-  x	Number	757
-  y	Number	177
-  3	Object
-  x	Number	29
-  y	Number	168
-  charInfo	Object[]		单字信息
-  0	Object
-  word	String	大	单字文字
-  prob	Number	99	单字置信度
-  x	Number	37	单字左上角横坐标
-  y	Number	102	单字左上角纵坐标
-  w	Number	59	单字宽度
-  h	Number	63	单字长度
-  tableId	Number	0	如果该文字块在表格内则存在该字段，tableId表示表格的id
-  tableCellId	Number	0	如果该文字块在表格内则存在该字段，表示表格中单元格的id
prism_tablesInfo	Object[]	[]
-  0	Object
-  tableId	Number	1	表格id，和prism_wordsInfo信息中的tableId对应
-  xCellSize	Number	1	表格中横坐标单元格的数量
-  yCellSize	Number	1	表格中纵坐标单元格的数量
-  cellInfos	Object[]		单元格信息，包含单元格在整个表格中的空间拓扑关系
-  0	Object
-  tableCellId	Number	1	表格中单元格id，和prism_wordsInfo信息中的tableCellId对应
-  word	String	abc	单元格中的文字
-  xsc	Number	1	xStartCell缩写，表示横轴方向该单元格起始在第几个单元格，第一个单元格值为0
-  xec	Number	1	xEndCell缩写，表示横轴方向该单元格结束在第几个单元格，第一个单元格值为0，如果xsc和xec都为0说明该文字在横轴方向占据了一个单元格并且在第一个单元格内
-  ysc	Number	1	yStartCell缩写，表示纵轴方向该单元格起始在第几个单元格，第一个单元格值为0
-  yec	Number	1	yEndCell缩写，表示纵轴方向该单元格结束在第几个单元格，第一个单元格值为0
-  pos	Object[]		单元格位置，按照单元格四个角的坐标顺时针排列，分别为左上XY坐标、右上XY坐标、右下XY坐标、左下XY坐标
-  0	Object
-  x	Number	1
-  y	Number	1
-  1	Object
-  x	Number	1
-  y	Number	1
-  2	Object
-  x	Number	1
-  y	Number	1
-  3	Object
-  x	Number	1
-  y	Number	1
height	Number	512
width	Number	1024
orgHeight	Number	512
orgWidth	Number	1024
content	String	大学生心理健康日的由来 为引导大中学生关注自身的心理健康，2000年，“5.25全国大中学生心理健康节”在北京师范大学拉开帷幕，健康节取“5.25”的谐音“我 爱我”，意为关爱自我的心理成长和健康，活动的主题是大中学生人际交往和互助问题，口号为“我爱我—―走出心灵的孤岛”。 此后(2004年)，教育部，团中央，全国学联办公室向全国大学生发出倡议，把每年的5月25日确定为全国大学生心理健康日。“5.25” 是“我爱我”的谐音，对此，发起人的解释是：爱自己才能更好的爱他人。心理健康的第一条标准就是认识自我，接纳自我，能体验到自 己存在的价值，乐观自信，这样的人才能用尊重，信任，友爱，宽容的态度与人相处，能分享，接受，给予爱和友谊，能与他人同心协力。选 择“5.25”是为了让大学生便于记忆，关注自己的心理健康。随后，“5.25——大学生心理健康日”在全国的高校得到认同，全国的高校都利用这一 天开展着多种形式的心理健康教育活动，甚至认为这一天就是“大学生的心理健康节”。 昵图网 wuu.nipic.com-m 010 N0220110523091121208380
...

返回示例：{ "showapi_res_error": "", "showapi_res_id": "671b4cc7b5bd413e98461482e98b131e", "showapi_res_code": 0, "showapi_res_body": { "sid": "31ccf0fa90b40423b8bf4fc2f0b50f05f036eb49b3d76b5b50a65fd356292a0855488b86", "prism_version": "1.0.9", "prism_wnum": 11, "angle": 0, "prism_wordsInfo": [ { "word": "大学生心理健康日的由来", "prob": 99, "pos": [ { "x": 30, "y": 101 }, { "x": 758, "y": 110 }, { "x": 757, "y": 177 }, { "x": 29, "y": 168 } ], "charInfo": [ { "word": "大", "prob": 99, "x": 37, "y": 102, "w": 59, "h": 63 } ] } ], "prism_tablesInfo": [], "height": 512, "width": 1024, "orgHeight": 512, "orgWidth": 1024, "content": "大学生心理健康日的由来 为引导大中学生关注自身的心理健康，2000年，“5.25全国大中学生心理健康节”在北京师范大学拉开帷幕，健康节取“5.25”的谐音“我 爱我”，意为关爱自我的心理成长和健康，活动的主题是大中学生人际交往和互助问题，口号为“我爱我—―走出心灵的孤岛”。 此后(2004年)，教育部，团中央，全国学联办公室向全国大学生发出倡议，把每年的5月25日确定为全国大学生心理健康日。“5.25” 是“我爱我”的谐音，对此，发起人的解释是：爱自己才能更好的爱他人。心理健康的第一条标准就是认识自我，接纳自我，能体验到自 己存在的价值，乐观自信，这样的人才能用尊重，信任，友爱，宽容的态度与人相处，能分享，接受，给予爱和友谊，能与他人同心协力。选 择“5.25”是为了让大学生便于记忆，关注自己的心理健康。随后，“5.25——大学生心理健康日”在全国的高校得到认同，全国的高校都利用这一 天开展着多种形式的心理健康教育活动，甚至认为这一天就是“大学生的心理健康节”。 昵图网 wuu.nipic.com-m 010 N0220110523091121208380 " } }