调用该接口通过图文识别技术识别出图片中的文字信息。
使用说明
调用该接口需要开通物联网平台新版公共实例或企业版实例服务。详细说明，请参见图文识别服务。
QPS限制
目前物联网平台增值服务中的图文识别服务处于公测阶段。
单个阿里云账号每天调用该接口次数最大为20次。
说明 RAM用户共享阿里云账号配额。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | RecognizePictureGeneral |
系统规定参数。取值：RecognizePictureGeneral。 |
| Url | String | 是 | https://img.alicdn.com/***/i4/O1***f_***-582.png |
待识别图片的URL地址。URL长度不超2048个字符，不支持base64编码。 |
调用API时，除了本文介绍的该API的特有请求参数，还需传入公共请求参数。公共请求参数说明，请参见公共参数文档。
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Code | String | 200 |
200表示成功。其它表示错误码。错误码详情，请参见错误码。 |
| Data | String | {"content":"***升维大提速***进一步了解***","height":655,"orgHeight":655,"orgWidth":805,"prism_version":"1.0.9","prism_wnum":11,"prism_wordsInfo":[{"angle":-88,"direction":0,"height":111,"pos":[{"x":351,"y":45},{"x":461,"y":46},{"x":461,"y":67},{"x":351,"y":66}],"prob":99,"width":20,"word":"iPhone 12","x":396,"y":0}],"width":805} |
调用成功时，返回识别出的文本信息。 |
| ErrorMessage | String | request parameter error |
调用失败时，返回的出错信息，如果调用成功，没有ErrorMessage字段。 |
| RequestId | String | 4C717018-B6D4-5EB0-8495-2A4FF08D58CA |
阿里云为该请求生成的唯一标识符。 |
| Success | Boolean | true |
是否调用成功。
|
Data数据说明：
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：文字块的文字。
-----------------------------------------------------------------------------------------------------------
示例
请求示例
http(s)://iot.cn-shanghai.aliyuncs.com/?Action=RecognizePictureGeneral
&Url=https://img.alicdn.com/***/i4/O1***f_***-582.png
&<公共请求参数>正常返回示例
XML格式
<RecognizePictureGeneralResponse>
<RequestId>4C717018-B6D4-5EB0-8495-2A4FF08D58CA</RequestId>
<Data>{"content":"***升维大提速***进一步了解***","height":655,"orgHeight":655,"orgWidth":805,"prism_version":"1.0.9","prism_wnum":11,"prism_wordsInfo":[{"angle":-88,"direction":0,"height":111,"pos":[{"x":351,"y":45},{"x":461,"y":46},{"x":461,"y":67},{"x":351,"y":66}],"prob":99,"width":20,"word":"iPhone 12","x":396,"y":0}],"width":805}</Data>
<Code>200</Code>
<Success>true</Success>
</RecognizePictureGeneralResponse>JSON格式
{
"RequestId": "4C717018-B6D4-5EB0-8495-2A4FF08D58CA",
"Data": "{\"content\":\"***升维大提速***进一步了解***\",\"height\":655,\"orgHeight\":655,\"orgWidth\":805,\"prism_version\":\"1.0.9\",\"prism_wnum\":11,\"prism_wordsInfo\":[{\"angle\":-88,\"direction\":0,\"height\":111,\"pos\":[{\"x\":351,\"y\":45},{\"x\":461,\"y\":46},{\"x\":461,\"y\":67},{\"x\":351,\"y\":66}],\"prob\":99,\"width\":20,\"word\":\"iPhone 12\",\"x\":396,\"y\":0}],\"width\":805}",
"Code": 200,
"Success": true
}